City Data – Veturilo Bicycle Rental Service

Transkrypt

City Data – Veturilo Bicycle Rental Service
Administracja (mapy rastrowe)
Zbiór danych Administracja jest mapą rastrową, która udostępnia wiele warstw zawierających
informacje takie jak: Biura Urzędu, Sądy, USC, Urzędy Dzielnic, ZUS, Urzędy Skarbowe, Ambasady.
Warstwy mapy
Nazwa warstwy w WMS
Opis
Identyfikator zasobu: resource_id
WMS/Administracja_ZUS
Oddziały ZUS
1e1cd865-0329-4f46-ad1a-527b4bddd721
WMS/Administracja_Urzedy_Skarbowe
Urzędy Skarbowe
967799c6-0abd-4b0f-945d-90963b4421d8
WMS/Administracja_Ambasady
Ambasady
2997db4b-4038-47fe-b042-5bf728c39aef
WMS/Administracja_Biura_Urzedu
Biura
Dzielnicowe
Urzędu Miasta
2e509f85-8bd7-4117-9604-da4142bf6605
WMS/Administracja_Konsulaty
Konsulaty
c6cc05d6-ade5-46e9-981d-da612032d668
WMS/Administracja_USC
Urzędy
Cywilnego
WMS/Administracja_Urzedy_Dzielnic
Urzędy Dzielnic
87bf1ddd-cb66-4389-90b3-28a1862fc04f
WMS/Administracja_Urzedy_Skarbowe
Urzędy Skarbowe
967799c6-0abd-4b0f-945d-90963b4421d8
Stanu
bb57eeb0-9373-4b6e-93c5-f7774c779426
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)
1

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ść)
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 Biura Urzędu (id =87bf1ddd-cb66-4389-90b3-28a1862fc04f)
Przykładowe wywołanie (format pliku PNG)
https://api.um.warszawa.pl/api/action/wmsstore_get?id=2e509f85-8bd7-4117-9604da4142bf6605&format=png&apikey=wartosc
2
Przykładowe wywołanie (wielkość obrazka - size 800x500)
https://api.um.warszawa.pl/api/action/wmsstore_get?id=2e509f85-8bd7-4117-9604da4142bf6605&size=800x500&apikey=wartosc
Przykładowe wywołanie (center 52.240616,20.998012)
https://api.um.warszawa.pl/api/action/wmsstore_get?id=2e509f85-8bd7-4117-9604da4142bf6605&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=2e509f85-8bd7-4117-9604da4142bf6605&zoom=10&apikey=wartosc
METADANE
Parametr
Opis
Identyfikator
f94d1043-cc05-4afc-b37e-818daf3e131a
Tytuł
Mapy Warszawy
Grupa
Dane przestrzenne
Opis
Mapy rastrowe Warszawy umożliwiające dostęp do wielu
poszczególnych warstw miasta. Obejmuje: biura Urzędu Miasta,
konsulaty, Urzędy Stanu Cywilnego, oddziały ZUS, urzędy
skarbowe, ambasady
Tag
Plan, warstwy, mapa, ZUS, urząd skarbowy, ambasada, konsulat,
USC, biuro,
Licencja
Dane Publiczne
Organizacja
BGiK
Status
danych
Źródło
zbioru Publiczny
WMS
3
Wersja
1.0
Autor
e-mail autora
Opiekun
e-mail opiekuna
Pola dodatkowe
4