Historia zmian:
Z radością, ale i pewną ciekawością udostępniamy wersję BETA API serwisu miejskiego Poznania. Dzięki temu każdy zainteresowany będzie miał możliwość stworzenia własnych aplikacji, które będą korzystały z danych pochodzących z portalu miejskiego.
Większość API opartego o dane przestrzenne powstała na podstawie materiałów dostarczonych przez Zarząd Geodezji i Katastru Miejskiego GEOPOZ. Dane dla cmentarzy powstaja przy współpracy z Universum.
Jeżeli będziesz korzystał z naszych danych, bądź fair. Wystarczy, że w swojej aplikacji podasz jako źródło danych platformę poznan.pl/api udostępnianą przez Urząd Miasta Poznania.
Obecnie możesz korzystać z następujących danych:
REST API dla danych przestrzennych:
UWAGA: domyślnie odpowiedź zwraca maksymalnie 3000 obiektów, aby zwiększyć maksymalną liczbę zwróconych obiektów należy dodać do żądania parametr "maxFeatures=N" gdzie N to liczba całkowita większa od 3000
- Wyszukiwarka adresów i ulic (dane aktualizowane codziennie):
- Api Featureserver
- Przykładowe wywołania:
- testowanie: http://www.poznan.pl/gis/poznan_2000_ulice.html - słownik ulic,wyszukiwanie ulic(linie łamane) i wyszukiwanie adresów(punkty), dodatkowe dane opisowe dla podanego adresu
- Formaty danych: GeoJSON, GML, GeoRSS (atom) i KML.
- Ulice
- Punkty adresowe
- Wybrane parametry opisowe:
- typ (os., ul., pl., zaułek, al.)
- nr - numer porządkowy
- wg_imienia nazwa ulicy wg imienia
- wg_imienia_wydruk nazwa ulicy wg imienia z dużymi literami
- wg_nazwiska nazwa ulicy wg nazwiska
- wg_nazwiska_wydruk nazwa ulicy wg nazwiska z dużymi literami
- kod - kod pocztowy dla rejonu w którym znajduje się adres
- obwody - nr obwodu wyborczego
- komisariat - nazwa rejonowego komisariatu policji
- samorzady_lokalne - nazwa samorządu lokalnego
- parafie - identyfikator parafii
- gimnazjum - nr gimnazjum
- podstawowa - nr szkoły podstawowej
- Api klasyczne (MIM) Przykład: http://www.poznan.pl/mim/public/plan/proxy.html?co=rss&street=Zwierzynie... otrzymujemy plik GeoRSS ze współrzędnymi adresu i informacjami o jego kodzie pocztowym, rejonie szkoły, okręgu wyborczym, parafii w której ten adres się znajduje itp. Współrzędne w układzie 2000.
- Wyszukiwarka grobów (FeatureServer) Udostępnione zostały dwie usługi oparte o HTTP GET, zwracające dane przestrzenne i opisowe o cmentarzach i grobach w jednym z czterech formatów: GeoJSON, GML, GeoRSS (atom) i KML. Dane aktualizowane są pod koniec stycznia, kwietnia, lipca i października.
- Cmentarze
- Listowane danych wszystkich cmentarzy
- http://www.poznan.pl/featureserver/featureserver.cgi/cmentarze/all.geojson
- http://www.poznan.pl/featureserver/featureserver.cgi/cmentarze/all.json
- http://www.poznan.pl/featureserver/featureserver.cgi/cmentarze/all.gml
- http://www.poznan.pl/featureserver/featureserver.cgi/cmentarze/all.atom
- http://www.poznan.pl/featureserver/featureserver.cgi/cmentarze/all.kml
- Przykład dla GeoJSON: {"features": [{"geometry": {"type": "Polygon", "coordinates": [[[16.932080524896701, 52.417713276854698], [16.9320556411413, 52.4187439528962], [16.933354952414799, 52.4187556728168], [16.933379805883298, 52.417724996493902], [16.932080524896701, 52.417713276854698]]]}, "id": 9, "properties": {"cm_name": "Bohater\u00f3w Polskich", "cm_q_quarter": 1, "cm_q_surname_name": 0, "cm_q_family": 0, "cm_q_date_birth": 1, "cm_q_date_death": 1, "cm_q_field": 0, "cm_q_row": 1, "cm_q_name": 1, "cm_type": "wojenny", "cm_q_date_burial": 0, "cm_q_surname": 1}}, … ]}
- Pole geometry – prostokąt ograniczający obrys cmentarza typu POLYGON w układzie WGS 84 (EPSG:4326)
- Pole id – identyfikator cmentarza wykorzystywany w serwisie z grobami
- Pola properties:
- Pobranie danych cmentarza o określonym id (przykład: id=1):
- Zapytanie zwracające dane dla cmentarza o podanej nazwie
- Groby
- Listowane grobów dla wszystkich cmentarzy (pobranie wszystkich grobów w żądaniu) nie jest zalecane - duży zbiór danych:
- Przykład odpowiedzi z 1 grobem w formacie GeoJSON: {"crs": {"type": "none", "properties": {"info": "No CRS information has been provided with this data."}}, "type": "FeatureCollection", "features": [{"geometry": {"type": "Point", "coordinates": [16.8267823576032, 52.391600961426001]}, "type": "Feature", "id": 10027166, "properties": {"g_date_birth": "1904-09-22", "g_quarter": "1", "g_surname": "czerwi\u0144ska", "g_surname_name": "czerwi\u0144ska ludwika", "g_place": "18", "g_date_death": "0001-01-01", "cm_id": 2, "g_row": "6", "g_family": "R", "g_name": "ludwika", "g_field": "31", "g_date_burial": "1978-03-21", "g_size": "2"}}, … ]
- Pole geometry – środek ciężkości grobu - punkt w układzie WGS 84
- Pole id – identyfikator grobu
- Pola properties:
- cm_id – identyfikator cmentarza
- g_quarter – numer kwatery
- g_surname – nazwisko
- g_surname_name – nazwisko i imię (imiona)* - dla cmentarzy: Lubowska i Samotna używane zamiast g_surname i g_name, dla cmentarza żołnierzy radzieckich pole jest wypełnione stopniem wojskowym
- g_place – numer miejsca
- g_date_death – data zgonu
- g_row – numer rzędu
- g_family – informacja o typie grobu
- g_name – imię (imiona)
- g_field – numer pola
- g_date_burial – data pogrzebu
- g_size – liczba osób pochowanych w grobie
- Stacje rowerów miejskich
- Punkty sprzedaży biletów
- Biletomaty
- Parkomaty
- Przystanki ZTM
- API Nowy Plan Poznania, format GeoJSON, układ odniesienia EPSG:4326:
- API Featureserver (dane aktualizowane do 30.06.2014) formaty danych: GeoJSON, GML, GeoRSS (atom) i KML. Formaty żądań zostały opisane w specyfikacjach wyszukiwarek grobów i adresów.
- Linie MPK (dane aktualizowane do 30.06.2014)
- API Featureserver, formaty danych: GeoJSON, GML, GeoRSS (atom) i KML. Formaty żądań zostały opisane w specyfikacjach wyszukiwarek grobów i adresów.
- Dane wyborcze - wybory do rad osiedli. Dane zaktualizowane w marcu 2015.
- Dane wyborcze -wybory samorządowe 2014. Dane zaktualizowane w październiku 2014.
- Obwody wyborcze
- API testowe (Featureserver) formaty danych: GeoJSON, GML, GeoRSS (atom) i KML. Formaty żądań zostały opisane w specyfikacjach wyszukiwarek grobów i adresów.
- Atrybuty opisowe:
- nr_obwodu - numer obwodu wyborczego
- Lokale Wyborcze
- API testowe (Featureserver) formaty danych: GeoJSON, GML, GeoRSS (atom) i KML. Formaty żądań zostały opisane w specyfikacjach wyszukiwarek grobów i adresów.
- Atrybuty opisowe:
- przystosowanie - przystosowanie lokalu dla osób niepełnosprawnych ("N" - lokal przystosowany dla osób niepełnosprawnych)
- siedziba - nazwa siedziby lokalu do głosowania
- nr_obwodu - numer obwodu wyborczego
- Zdjęcia lokali wyborczych
- Samorządy pomocnicze
- Bezprzewodowy Poznań wireless.poznan.pl aktualizacja 15.12.2014
- Rejony szkół (API Nowy Plan Poznania, EPSG:4326)
- Parafie (API Nowy Plan Poznania, EPSG:4326)
- Nieruchomości na sprzedaż (API Nowy Plan Poznania, EPSG:4326)
- Turystyka (API Nowy Plan Poznania, EPSG:4326)
- Urbanistyka - Miejscowe Plany Zagospodarowania Przestrzennego (API Nowy Plan Poznania, EPSG:4326)
- Urbanistyka - wnioski i decyzje POI (API Nowy Plan Poznania, EPSG:4326)
- Środowisko - wnioski i decyzje POI (API Nowy Plan Poznania, EPSG:4326) BIP
- Środowisko - ścieki
- serwisy mapowe w postaci usług WMS-C (tiled WMS) i TMS, które mogą zostać udostępnione w aplikacjach webowych za pośrednictwem Openlayers albo Leaflet.
USŁUGI SIECIOWE - webservices
Na chwilę obecną udostępnione publicznie są następujące usług:
- informacje na temat wydarzeń - https://www.um.poznan.pl/web-service/events?wsdl
Wynikiem metod jest plik XML o zawartości zgodnej z XSD - http://sit-wlkp.eu/xmlrepo/events.xsd. Maksymalna liczba wyników ograniczona jest do 250 wydarzeń. Powyższy WSDL udostępnia następujące metody:
getEvents- w wyniku uzyskasz plik XML ze wszystkimi wydarzeniami, które zaczynają od daty dateFrom a kończą przed datą dateTo Parametry wywołania:
- dateFrom - data od w formacie yyyy-mm-dd
- dateTo - data do w formacie yyyy-mm-dd
getEventsFromDate- w wyniku uzyskasz plik XML ze wszystkimi wydarzeniami od daty dateFrom Parametry wywołania:
- dateFrom - data od w formacie yyyy-mm-dd
getEventsToDate- w wyniku uzyskasz plik XML ze wszystkimi wydarzeniami do daty dateTo Parametry wywołania:
- dateTo - data do w formacie yyyy-mm-dd
getDayEvent- w wyniku uzyskasz plik XML ze wszystkimi wydarzeniami z konkretnego dnia Parametry wywołania:
- date - data w formacie yyyy-mm-dd
Udostępnony został również klient, który udostępnia dane poprzez HTTP.
- informacje na temat obiektów - https://www.um.poznan.pl/web-service/objects?wsdl Wynikiem metod jest plik XML o zawartości zgodnej z XSD - http://sit-wlkp.eu/xmlrepo/object.xsd. Powyższy WSDL udostępnia następujące metody:
getObjectCategories - w wyniku uzyskasz dane w formacie JSON ze wszystkimi kategoriami. Wynik zawiera mapę z id kategorii oraz nazwą kategorii.
getObjectsInCategory- w wyniku uzyskasz plik XML ze wszystkimi obiektami w kategorii. Parametry wywołania:
- category - identyfikator kategorii
Udostępnony został również klient, który udostępnia dane poprzez HTTP.
- informacje na temat aktualności - https://www.um.poznan.pl/web-service/news?wsdl Wynikiem metod jest plik XML o zawartości zgodnej z XSD - http://www.poznan.pl/mim/xmlschema/sit-wlkp/2013/12/10/news.xsd. Maksymalna liczba wyników ograniczona jest do 250 wydarzeń. Powyższy WSDL udostępnia następujące metody:
getNews- w wyniku uzyskasz plik XML ze wszystkimi wiadomościami pomiędzy datą od a datą do Parametry wywołania:
- dateFrom - data od w formacie yyyy-mm-dd
- dateTo - data do w formacie yyyy-mm-dd
getNewsFromDate- w wyniku uzyskasz plik XML ze wszystkimi wiadomościami od daty od Parametry wywołania:
- dateFrom - data od w formacie yyyy-mm-dd
getNewsToDate- w wyniku uzyskasz plik XML ze wszystkimi wiadomościami do daty do Parametry wywołania:
- dateTo - dat do w formacie yyyy-mm-dd
getDayNews- w wyniku uzyskasz plik XML ze wszystkimi wiadomościami dla konkretnej daty Parametry wywołania:
- date - data w formacie yyyy-mm-dd
getCurrentDayNews - w wyniku uzyskasz plik XML ze wszystkimi wiadomościami z dnia bieżącego
getCurrentDayNewsInstanceCategory - pobieranie aktualności dla zdefiniowanej instancji oraz kategorii
Udostępnony został również klient, który udostępnia dane poprzez HTTP.
- informacja na temat linii komunikacji miejskiej Poznania: https://www.um.poznan.pl/web-service/mpklines?wsdl
getBusLines– zwraca posortowaną listę linii autobusowych, które występują w obowiązującym rozkładzie jazdy. Parametry wywołania:
- String json – zapytanie w formacie JSON, które zawiera pole 'type', którego wartość przyjmuje 'n' dla linii nocnych i 'd' dla linii dziennych
Przykładowe wywołanie: json=%7B%22type%22%3A%22n%22%7D Przykładowa odpowiedź:
{"status":"ok","lines":["231","232","233","234","235","236","237","238","239","240","241","242","243","244","245","246","247","248","249","251","252"]}
gdzie:
- status – to status odpowiedzi – 'ok' gdy żądanie zostanie obsłużone poprawnie lub 'error', gdy wystąpi błąd,
- lines – lista linii,
- descrition – zwracane gdy status == error – krótki opis błedu.
getTramLines– zwraca posortowaną listę linii tramwajowych, które występują w obowiązującym rozkładzie jazdy. Parametry:
- String json – zapytanie w formacie JSON, które zawiera pole 'type', którego wartość przyjmuje 'n' dla linii nocnych i 'd' dla linii dziennych
Przykładowe wywołanie: json=%7B%22type%22%3A%22n%22%7D Przykładowa odpowiedź:
{"status":"ok","lines":["N21"]}
gdzie:
- status – to status odpowiedzi – 'ok' gdy żądanie zostanie obsłużone poprawnie lub 'error', gdy wystąpi błąd,
- lines – lista linii,
- descrition – zwracane gdy status == error – krótki opis błedu.
- generowanie fotokodów: https://www.um.poznan.pl/ws/services/QRCode?wsdl W ramach tej usługi sieciowej udostępnione zostały metody do genrowania fotokodów. Parametry wejściowe, które służą do określenia rozmiaru, to: qRsize - przyjmuje on wartości większe od 0px fontSize - w przypadku podania rozmiaru więksego od 0, do wygenerowanego fotokodu zostanie załączony tekst, który został użyty do jego stworzenia.
PRZEWODNIK MULTIMEDIALNY - przeczytaj więcej na jego temat na naszej stronie http://egov.psnc.pl/node/19
Jak skorzystać z API?
Obecny interfejs udostępniania treści przewodników jest prostym interfejsem tekstowym opartym o zapytania HTTP. Odpowiedź jest przesyłana w formie tekstowej (nie html ani xml). Każdy zwracany element jest opisany jedną linią tekstu zawierającą listę parametrów. Parametry są oddzielone znacznikami „0x1234”. Poszczególne parametry są zapisane w formie: <nazwa_parametru>:<wartość> Pozwala to na łatwe odczytanie i przetwarzanie parametrów. W ramach przewodnika multimedialnego zostały udostępnione poniżej wymienione funkcje:
- Pobranie listy dostępnych przewodników
Zapytanie: http://www.poznan.pl/mim/public/przewodnik/przewodnik_m.html?co=guides
Parametery odpowiedzi: Pary <lang>:<tytuł> mogą wystąpić wielokrotnie, po jednym dla każdej dostępnej wersji językowej przewodnika. <lang> w tym przypadku oznacza kod wersji językowej (np.: pl, en, de)
Przykładowa odpowiedź: guide:50x1234de:Malta0x1234en:Malta0x1234pl:Malta0x1234
Linia ta zawiera informacje: Przewodnik (guide) o identyfikatorze 5 w trzech wersjach językowych: niemieckiej (de), angielskiej (en) i polskiej (pl). W tym przypadku tytuły we wszystkich językach są takie same (Malta).
- Pobranie informacji startowych przewodnika
Zapytanie: http://www.poznan.pl/mim/public/przewodnik/przewodnik_m.html?co=guide&pr... gdzie przyjęto następujące parametry: <guide_id> - identyfikator przewodnika, <lang> - kod wersji językowej (pl, en, ...)
Przykładowe zapytanie: http://www.poznan.pl/mim/public/przewodnik/przewodnik_m.html?co=guide&pr...
Parametry odpowiedzi:
- g_info - Identyfikator przewodnika
- lang - Wybrany język
- title - Tytuł przewodnika
- desc - Opis przewodnika
- imgUrl - Url głównego obrazu przewodnika
- Strona z mapą związaną z danym przewodnikiem
Nie jest to zapytanie, ale adres pod którym jest dostępna mapa przewodnika: http://www.poznan.pl/mim/public/przewodnik/przewodnik_m.html?co=plan&pr_...
Przykład: http://www.poznan.pl/mim/public/przewodnik/przewodnik_m.html?co=plan&pr_...
Odpowiedzią jest strona www zawierająca tylko mapę związaną z danym przewodnikiem
- Pobranie listy obiektów dla danego przewodnika
Zapytanie: http://www.poznan.pl/mim/public/przewodnik/przewodnik_m.html?co=cat&pr_i...
Przykład: http://www.poznan.pl/mim/public/przewodnik/przewodnik_m.html?co=cat&pr_i...
Parametry: <guide_id> - identyfikator przewodnika <lang> - kod wersji językowej (pl, en, ...)
Odpowiedzią jest zbiór klas obiektów w ramach przewodnika oraz lista obiektów należących do tych klas. Po linii zawierającej informacje o klasie następuje lista obiektów należących do tej klasy.
Parametry obiektów:
- poi - Identyfikator obiektu
- name - Nazwa obiektu
- desc - Opis obiektu
- email - Adres email danego obiektu (opcjonalny)
- address - Adres danego obiektu (opcjonalny)
Parametry klasy:
- subclass - Identyfikator kategorii obiektów
- name - Nazwa kategorii obiektów
- icon_name - Nazwa ikony kategorii
- icon_url - Url ikony kategorii
INTERWENCJE POZNAŃ API
Udostepniony interfejs pozwala na składania zgłoszeń służbom miejskim Poznania. Obecnie do tych służb nalezy Straż miejska i MPK. Więcej na temat API pod adresem: http://egov.psnc.pl/node/37
KANAŁY RSS
Aktualną listę kanałów RSS znajdziesz na stronie http://www.poznan.pl/mim/public/feeds/. Udostępniane są one w formacie RSS 2.0 i Atom 1.0. Dane te można również wykorzystać w dowolny sposób w swoich aplikacjach.
Web scraping
Zachęcamy również do wykorzystania techniki Web Scraping dla stron http://www.poznan.pl oraz http://bip.um.poznan.pl/, jeżeli interesujące Ciebie dane nie są udostępnione poprzez API. Będziemy wdzięczni, jeżeli poinformujesz nas , które dane należałoby udostępnić poprzez API. Rozważymy Twoją prośbę w następnych jego aktualizacjach. W tej chwili udostępniamy API w wersji BETA, co oznacza że cały czas pracujemy nad ulepszeniem interfejsu. O wszelkich zmianach będziemy informowali na bieżąco. Zespół eGovernment PCSS egov@man.poznan.pl
Nextbike
Na stronach firmy Nextbike znajduje się dokumentacja API umożliwiająca pobranie informacji związanych z usługą Poznański Rowerer Miejski - https://nextbike.net/maps/nextbike-official.xml
Odpowiedzi
zapytanie
Widzialem ze macie przystanki i linie. Czy sa w planach trasy linii i rozklad jazdy?
ODPOWIEDŹ:
Położenie przystanków oraz linii jest udostępnione poprzez API. W tej chwili nie planujemy udostępnienia rozkładów poprzez API. W tej chwili mogę tylko zaproponować skorzystanie z WebScraping. / Dariusz Janny
Sugestie dot. API
W api przydało by sie ze strony bip.poznan.pl Jednostki organizacyjne Urzędu Miasta, wykaz biur i wdziałów z adresami i godzinami otwarc, oferty pracy.
ODPOWIEDŹ:
Do momentu uruchomienia wersji BETA API, aż do zakończenia imprezy programistycznej HACKATON nie chcemy wprowadzać żadnych zmian i udostępniać kolejnych danych.
Informacje udostępniane w BIP (Biuletynie Informacji Publicznej) na stronie bip.um.poznan.pl planowane są do uruchomienia w kolejnych etapach. / Dariusz Janny
getObjectsInCategory nie działa..
Przykładowo:
http://www.poznan.pl/mim/public/ws-information/?co=getObjectsInCategory&category=1476
otwarte w przeglądarce powinno wg. dokumentacji zwrócić liste kortów tenisowych w Poznaniu. Tymczasem dla tej (i kilku innych kategorii które sprawdzałem) dostaje pustą odpowiedź (XML ale bez treści).
Filip
ODPOWIEDŹ:
Lista wszystkich klas jest dostępna pod adresem http://www.poznan.pl/mim/public/ws-information/?co=getCategories, listę obiektów klasie kortów tenisowych mozna znaleźć pod adresem: http://www.poznan.pl/mim/public/ws-information/?co=getObjectsInCategory&... / Dariusz Janny
Odpowiedz