City Data – Veturilo Bicycle Rental Service

Transkrypt

City Data – Veturilo Bicycle Rental Service
Rowery (mapy rastrowe)
Zbiór danych Rowery udostępnia mapy z lokalizacją samoobsługowych serwisów iBombo i
serwisów rowerowych.
Warstwy mapy
Nazwa warstwy w WMS
Opis
Identyfikator zasobu: resource_id
WMS/serwisy_ibombo_sa
moobs
Serwisy_ibombo_
samoobsługowe
396cf494-110d-4a81-8cba-76f449377943
WMS/serwisy_rowerowe
Serwisy_rowerowe
45dec7cc-4ea0-426c-8957-400ab07d3678
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

size - rozmiar mapy wyrażony w pikselach (size= szerokość x wysokość)
1
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:
„Serwisy_rowerowe”: (id=45dec7cc-4ea0-426c-8957-400ab07d3678)
Przykładowe wywołanie (format pliku PNG)
https://api.um.warszawa.pl/api/action/wmsstore_get?id=45dec7cc-4ea0-426c-8957400ab07d3678&format=png&apikey=wartosc
Przykładowe wywołanie (wielkość obrazka - size 800x500)
https://api.um.warszawa.pl/api/action/wmsstore_get?id=45dec7cc-4ea0-426c-8957400ab07d3678&size=800x500&apikey=wartosc
Przykładowe wywołanie (center 52.240616,20.998012)
https://api.um.warszawa.pl/api/action/wmsstore_get?id=45dec7cc-4ea0-426c-8957400ab07d3678&center=52.240616,20.998012&apikey=wartosc
Przykładowe wywołanie (powiększenie - zoom 10)
2
https://api.um.warszawa.pl/api/action/wmsstore_get?id=45dec7cc-4ea0-426c-8957400ab07d3678&zoom=10&apikey=wartosc
METADANE
Parametr
Opis
Identyfikator
8fb6db82-0c28-4554-aa0b-fcb1b2c17c8f
Tytuł
Rowery
Grupa
Transport
Opis
Lokalizacja serwisów rowerowych
Tag
Mapa, plan, rower, serwis
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