City Data – Veturilo Bicycle Rental Service

Transkrypt

City Data – Veturilo Bicycle Rental Service
Informacja turystyczna (mapy rastrowe)
Zbiór danych udostępnia mapę rastrową, której warstwy zwracają lokalizację Punktów
Informacji Turystycznej i Punktów Informacyjnych Miejskiego Systemu Informacji (MSI).
Warstwy mapy
Nazwa warstwy
Opis
Identyfikator zasobu: resource_id
WMS/Turystyka_Punkty_IT
Punkty Informacji
Turystycznej
2e5e8e7c-bb01-448b-892d18dacfc697cf
WMS/Turystyka_punkty_infor
macyjne_msi
Punkty Informacyjne
Miejskiego Systemu
Informacji
425ebd40-7937-4091-885b092cf62ada3f
Metoda HTTP
GET
URI
https://api.um.warszawa.pl/api/action/wmsstore_get?&apikey=value&
id=id&format=png&center=latitude,longitude&zoom=value&size=widexheigh
Parametry wywołania
Parametry wywołania są następujące:

apikey - identyfikator dostępu do API (dostęp do tego zasobu wymaga rejestracji na portalu
api.um.warszawa.pl i pobrania wartości apikey)

Id – identyfikator zasobu (uwaga wartość id podana w dokumentacji może być przykładowa
– poprawne id przydzielone do poszczególnych zasobów zawiera portal api.um.warszawa.pl)

center - współrzędne geograficzne (długość, szerokość) środka mapy (center= longitude,
latitude)
Współrzędne powinny być wartościami typu float zgodnymi z normą EPSG 4326 (WGS84).
Przykład: długość geogr.: 20.992, szerokość geogr.: 51.242.

zoom - poziom zbliżenia mapy (zoom=value)
Wartość typu Int z zakresu 10-21
1

size - rozmiar mapy wyrażony w pikselach (size= szerokość x wysokość)
Wartość typu Int z zakresu 1-1000

format - format obrazu (format= value)
Format - prawidłowe wartości: png lub jpeg
Parametry id i apikey są obowiązkowe. Pozostałe parametry powinny być również zdefiniowane w
celu otrzymania pożądanego wyglądu mapy. Jeżeli użytkownik nie określi lub nie poda parametru
zwracana jest odpowiedź http o błędzie z następującym opisem tekstowym
{ “success” : status , "error": {"__error_type": "error_description", "message": "message_text"}}
np :
{"success": false, "error": {"__type": "Validation Error", "id": ["id required"]}}
Opcjonalnie serwer WMS może również zwrócić odpowiedź o błędzie w formacie tekstowym, np.
wyjątek podczas generowania obrazu mapy.
Obraz mapy zwracany przez serwer WMS może być pusty w przypadku nieprawidłowej wartości
parametrów zoomu lub rozmiaru obrazu (np. kiedy zbliżenie jest zbyt małe aby uwidocznić żądane
szczegóły na mapie). Obrazki są kodowane base64 i zwracane jako obiekty JSON.
Przykładowe wywołania
Przykładowe wywołanie dla warstwy:
Punkty Informacji Turystycznej (id= 2e5e8e7c-bb01-448b-892d-18dacfc697cf)
Przykładowe wywołanie
https://api.um.warszawa.pl/api/action/wmsstore_get?id=2e5e8e7c-bb01-448b-892d18dacfc697cf&apikey=wartosc
Przykładowe wywołanie (format pliku PNG)
https://api.um.warszawa.pl/api/action/wmsstore_get?iid=2e5e8e7c-bb01-448b-892d18dacfc697cf&format=png&apikey=wartosc
Przykładowe wywołanie (wielkość obrazka - size 800x500)
https://api.um.warszawa.pl/api/action/wmsstore_get?id=2e5e8e7c-bb01-448b-892d18dacfc697cf&size=800x500&apikey=wartosc
Przykładowe wywołanie (center 52.240616,20.998012)
2
https://api.um.warszawa.pl/api/action/wmsstore_get?id=2e5e8e7c-bb01-448b-892d18dacfc697cf&center=52.240616,20.998012&apikey=wartosc
Przykładowe wywołanie (powiększenie - zoom 10)
https://api.um.warszawa.pl/api/action/wmsstore_get?id=2e5e8e7c-bb01-448b-892d18dacfc697cf&zoom=10&apikey=wartosc
METADANE
Parametr
Opis
Identyfikator
4e090034-9fbb-45ee-aba7-35a85fd423a4
Tytuł
Informacja turystyczna
Grupa
sport i rekreacja
Opis
Mapy rastrowe, której warstwy zwracają lokalizację Zbiór danych
udostępnia mapę rastrową, której warstwy zwracają lokalizację
Punktów Informacji Turystycznej i Punktów Informacyjnych
Miejskiego Systemu Informacji (MSI).
Tag
Plan, mapa, informacja turystyczna, MSI
Licencja
Dane publiczne
Organizacja
BGiK
Status zbioru
danych
Publiczny
Źródło
WMS
Wersja
1.0
Autor
e-mail autora
Opiekun
e-mail opiekuna
Pola dodatkowe
3