City Data – Veturilo Bicycle Rental Service

Transkrypt

City Data – Veturilo Bicycle Rental Service
Baza noclegowa (mapy rastrowe)
Zbiór danych udostępnia mapę rastrową, której warstwy zwracają lokalizację obiektów
noclegowych obejmujących: akademiki, apartamenty, campingi, hotele i schroniska
młodzieżowe.
Warstwy mapy
Nazwa warstwy
WMS/Baza_noclegowa_Akademiki
Opis
Akademiki
WMS/Baza_noclegowa_Apartamenty Apartamenty
WMS/Baza_noclegowa_Campingi
Campingi
WMS/Baza_noclegowa_Hotele
Hotele
WMS/Baza_noclegowa_Schroniska
Schroniska młodzieżowe
Identyfikator zasobu: resource_id
a0459cb4-cf3a-4902-84be-7ca1b48484c8
1c33ee4e-8858-43bc-8ef2-5d08224da8fb
53a15a83-b454-40a5-86f0-802620949b2c
f98aec39-041a-4b57-ba75-3f8fbb427ddc
0df6c632-7cdf-42ca-927f-37134b767860
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.
1

zoom - poziom zbliżenia mapy (zoom=value)
Wartość typu Int z zakresu 10-21

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łanie
Przykładowe wywołanie dla warstwy:
„Hotele” (id= 98aec39-041a-4b57-ba75-3f8fbb427ddc)
Przykładowe wywołanie (format pliku PNG)
https://api.um.warszawa.pl/api/action/wmsstore_get?id=f98aec39-041a-4b57-ba753f8fbb427ddc&format=png&apikey=wartosc
Przykładowe wywołanie (wielkość obrazka - size 800x500)
https://api.um.warszawa.pl/api/action/wmsstore_get?id=f98aec39-041a-4b57-ba753f8fbb427ddc&size=800x500&apikey=wartosc
Przykładowe wywołanie (center 52.240616,20.998012)
2
https://api.um.warszawa.pl/api/action/wmsstore_get?id=f98aec39-041a-4b57-ba753f8fbb427ddc& 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=f98aec39-041a-4b57-ba753f8fbb427ddc&zoom=10&apikey=wartosc
METADANE
Parametr
Opis
Identyfikator
d81daa8f-789c-4b7d-8daf-2b8d1d443788
Tytuł
Baza noclegowa
Grupa
Dane przestrzenne
Opis
Mapy rastrowe, której warstwy zwracają lokalizację
następujących kategorii obiektów noclegowych: akademiki,
apartamenty, campingi, hotele i schroniska młodzieżowe.
Tag
Nocleg, akademik, apartament, camping, hotel, schronisko
młodzieżowe
Licencja
Dane publiczne
Organizacja
BGiK
Status
danych
zbioru Publiczny
Źródło
WMS
Wersja
1.0
Autor
e-mail autora
Opiekun
e-mail opiekuna
Pola dodatkowe
3