poznan.pl API - beta

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.

Jeżeli będziesz korzystał z naszych danych, bądź fair. Wystarczy, że w swojej aplikacji podasz link do źródła danych.

Obecnie możesz korzystać z następujących danych:

API dla danych przestrzennych:

• wyszukiwarka adresów i ulic:
  • Api testowe (Featureserver)
  • Przykładowe wywołania:
  • http://www.poznan.pl/featureserver/featureserver.cgi/ulice/all.json - lista ulic w formacie GeoJSON
  • http://www.poznan.pl/featureserver/featureserver.cgi/ulice/all.gml?maxFe... - lista ulic w formacie GML ograniczona do 4 elementów
  • http://www.poznan.pl/featureserver/featureserver.cgi/ulice/all.kml?query... -  geometria ulicy Wichrowej w formacie KML
  • http://www.poznan.pl/featureserver/featureserver.cgi/adresy/all.atom?que... - lista punktów adresowych przy ulicy Wichrowej
  • http://www.poznan.pl/featureserver/featureserver.cgi/adresy/all.atom?que... - punkt adresowy Wichrowa 1
  • http://www.poznan.pl/featureserver/featureserver.cgi/adresy/37889.atom - obiekt o id=37889 w formacie GeoRSS
  • parametr bbox=<min lat>,<min lon>,<max lat>,<max lon> ogranicza zwracany wynik do prostokatu ograniczonego podanymi współrzędnymi
  • 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
  • System WGS (EPSG:4326): http://www.poznan.pl/featureserver/featureserver.cgi/ulice_wgs/
  • Układ 2000 (EPSG:2177): http://www.poznan.pl/featureserver/featureserver.cgi/ulice/
  • Parametry opisowe:
  • a3 - nazwy ulic wg nazwiska
  • a6 - nazwy ulic wg imienia
  • a5 - nazwy ulic skrócone (samo nazwisko)
  • a4 (ul., pl., dr.wew, tunel, most)
  • l - długość w metrach
  • Punkty adresowe
  • System WGS (EPSG:4326): http://www.poznan.pl/featureserver/featureserver.cgi/adresy_wgs/
  • Układ 2000 (EPSG:2177): http://www.poznan.pl/featureserver/featureserver.cgi/adresy/
  • 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.

• Cmentarze
  • Listowane danych wszystkich cmentarzy
  • 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:
  • pola opisowe
    • cm_type – pole tekstowe, typ cmentarza: "zabytkowy", "parafialny", "wojenny", "wojskowy",”komunalny”
    • cm_name – pole tekstowe, nazwa cmentarza

    pola wskazujące kryteria wyszukiwania (1 – używać, 0 – nie używać dla danego cmentarza)

    • cm_q_date_death – pole typu integer, przyjmuje wartości [0,1]
    • cm_q_field – przyjmuje wartości [0,1]
    • cm_q_date_burial – przyjmuje wartości [0,1]
    • cm_q_name – przyjmuje wartości [0,1]
    • cm_q_surname – przyjmuje wartości [0,1]
    • cm_q_family – przyjmuje wartości [0,1]
    • cm_q_date_birth – przyjmuje wartości [0,1]
    • cm_q_row – przyjmuje wartości [0,1]
    • cm_q_quarter – przyjmuje wartości [0,1]
    • cm_q_surname_name – przyjmuje wartości [0,1]
  • Pobranie danych cmentarza o określonym id (przykład: id=1):
  • http://www.poznan.pl/featureserver/featureserver.cgi/cmentarze/1.json
  • http://www.poznan.pl/featureserver/featureserver.cgi/cmentarze/1.atom
  • http://www.poznan.pl/featureserver/featureserver.cgi/cmentarze/1.kml
  • http://www.poznan.pl/featureserver/featureserver.cgi/cmentarze/1.gml
  • Zapytanie zwracające dane dla cmentarza o podanej nazwie
  • http://www.poznan.pl/featureserver/featureserver.cgi/cmentarze/all.json?...
• Groby
  • Listowane danych wszystkich cmentarzy (nie zalecane - duzy zbiór danych):
  •  http://www.poznan.pl/featureserver/featureserver.cgi/groby/all.json?maxf...
  • Przykład 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)
    • g_place – numer kwatery
    • g_date_death – numer kwatery
    • 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
  • Pobranie danych grobu na podstawie kryteriów zapytania http://www.poznan.pl/featureserver/featureserver.cgi/groby?maxFeatures=1... http://www.poznan.pl/featureserver/featureserver.cgi/groby/all.gml?maxFe...
  • Pobranie danych grobu na podstawie id http://www.poznan.pl/featureserver/featureserver.cgi/groby/10027166.json
  • Pobranie listy danych grobów na podstawie minimalnego prostokąta ograniczającego http://www.poznan.pl/featureserver/featureserver.cgi/groby/all.json?bbox...

• Biletomaty
  • API klasyczne (używane w Planie Poznania - MIM), tylko układ współrzędnych "2000" (EPSG:2177) http://www.poznan.pl/mim/public/plan/plan.html?co=rss&service=biletomaty udostępniamy plik w formacie GeoRSS z listą biletomatów, ich opisem i lokalizacją.
  • API testowe (Featureserver), formaty danych: GeoJSON, GML, GeoRSS (atom) i KML. Formaty żądań zostały opisane w specyfikacjach wyszukiwarek grobów i adresów.
  • System WGS (EPSG:4326): http://www.poznan.pl/featureserver/featureserver.cgi/biletomaty_wgs/
  • Układ 2000 (EPSG:2177): http://www.poznan.pl/featureserver/featureserver.cgi/biletomaty/
• Parkomaty
• API testowe (Featureserver) formaty danych: GeoJSON, GML, GeoRSS (atom) i KML. Formaty żądań zostały opisane w specyfikacjach wyszukiwarek grobów i adresów.
• System WGS (EPSG:4326): http://www.poznan.pl/featureserver/featureserver.cgi/parkomaty_wgs/
• Układ 2000 (EPSG:2177): http://www.poznan.pl/featureserver/featureserver.cgi/parkomaty/
• Przystanki MPK (dane z kwietnia 2011)
• API testowe (Featureserver) formaty danych: GeoJSON, GML, GeoRSS (atom) i KML. Formaty żądań zostały opisane w specyfikacjach wyszukiwarek grobów i adresów.
• System WGS (EPSG:4326): http://www.poznan.pl/featureserver/featureserver.cgi/mpk_przystanki_wgs/
• Układ 2000 (EPSG:2177): http://www.poznan.pl/featureserver/featureserver.cgi/mpk_przystanki/
• Linie MPK (dane z kwietnia 2011)
• API testowe (Featureserver) formaty danych: GeoJSON, GML, GeoRSS (atom) i KML. Formaty żądań zostały opisane w specyfikacjach wyszukiwarek grobów i adresów.
• System WGS (EPSG:4326): http://www.poznan.pl/featureserver/featureserver.cgi/mpk_linie_wgs/
• Układ 2000 (EPSG:2177): http://www.poznan.pl/featureserver/featureserver.cgi/mpk_linie/
• Wybory Parlamentarne 2011
• 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.
• System WGS (EPSG:4326): http://www.poznan.pl/featureserver/featureserver.cgi/wybory_2011_obwody_...
• Układ 2000 (EPSG:2177): http://www.poznan.pl/featureserver/featureserver.cgi/wybory_2011_obwody/
• 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.
• System WGS (EPSG:4326): http://www.poznan.pl/featureserver/featureserver.cgi/wybory_2011_lokale_...
• Układ 2000 (EPSG:2177): http://www.poznan.pl/featureserver/featureserver.cgi/wybory_2011_lokale/
• 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
• Podobnie do biletomatów w MIMie wystawiamy dane w formacie GeoRSS:
  • Lokalach wyborczych: http://www.poznan.pl/mim/public/plan/plan.html?co=rss&service=lokale_wyb...
  • Szkołach gimnazjalnych: http://www.poznan.pl/mim/public/plan/plan.html?co=rss&service=rejony_gim...
  • Szkołach podstawowych: http://www.poznan.pl/mim/public/plan/plan.html?co=rss&service=rejony_pod...
  • Kościołach parafialnych: http://www.poznan.pl/mim/public/plan/plan.html?co=rss&service=parafie
• serwisy mapowe w postaci usług WMS-C (tiled WMS) i TMS, które mogą zostać udostępnione za pośrednictwem Openlayers.
• Adres usługi TMS: http://www.poznan.pl/tilecache/tilecache.cgi .
• Opis usługi zgodny ze specyfikacją WMS: http://www.poznan.pl/tilecache/tilecache.cgi?service=wms&version=1.1.1&r....
• Przykład wykorzystania usług w interaktywnej mapie zbudowanej na bazie OpenLayers: http://www.poznan.pl/plan
• Odwzorowanie Sperical Mercator (EPSG:900913) :
  • Przykład zastosowania z podkładem Google Maps i inymi: http://www.poznan.pl/gis/poznan_SM.html
  • Warstwa bazowa, plan Poznania: poznan_plan_SM2
  • Warstwa bazowa, plan Poznania - hybryda : plan_hybryda_2010_900913
  • Warstwa dodatkowa, Poznańskie cmentarze: poznan_cmentarze_SM2

  Odwozrowanie Układ 2000 (EPSG:2177)

  • Przykład wykorzystania usług w interaktywnej mapie zbudowanej na bazie OpenLayers: http://www.poznan.pl/plan
  • plan_2177 - plan Poznania
  • ortofotomapa - widok "z lotu ptaka", dostępna w trzech wersjach:
  • plan_orto_2010_2177 - ortofotomapa na bazie zdjęć z 2010 roku
  • plan_orto_2177 - ortofotomapa na bazie zdjęć z 2008 roku
  • plan_orto_2006_2177 - ortofotomapa na bazie zdjęć z 2006 roku
  • hybryda - widok "z lotu ptaka" plus ulice i nazwy, dostępna w trzech wersjach:
  • plan_hybryda_2010_2177 - hybryda na bazie zdjęć z 2010 roku
  • plan_hybryda_2177 - hybryda na bazie zdjęć z 2008 roku
  • plan_hybryda_2006_2177 - hybryda na bazie zdjęć z 2006 roku
  • przewodnik_2177 - baza dla przewodnika turystycznego
  • Warstwy dodatkowe:
  • plan_rower_2177
  • plan_szlaki_2177
  • plan_sciezki_2177
  • plan_budynki_2177
  • plan_mpk_przystanki_2177
  • plan_mpk_linie_2177
  • parafie_2177
  • plan_wybory_obwody_lokale_2177
  • plan_gimnazja_2177
  • plan_podstawowe_2177
  • samorzady_lokalne_2011_2177
  • poznan_cmentarze_2177

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/ws/services/events?wsdl
  Wynikiem metod jest plik XML o zawartości zgodnej z XSD - http://sit-wlkp.eu/xmlrepo/events.xsd. 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.

• http://www.poznan.pl/mim/public/ws-information/?co=getCurrentDayEvents - lista wydarzeń z dzisiaj
• http://www.poznan.pl/mim/public/ws-information/?co=getDayEvent&date<yyyy... - wydarzenia z konkretnego dnia
• http://www.poznan.pl/mim/public/ws-information/?co=getEventsToDate&dateT... - lista wydarzeń do konkrentej daty
• http://www.poznan.pl/mim/public/ws-information/?co=getEventsFromDate&dat... - lista wydarzeń od konkrentej daty
• http://www.poznan.pl/mim/public/ws-information/?co=getEvents&dateTo=<yyy... - lista wydarzeń pomiędzy zdefiniowanymi datami
• informacje na temat obiektów - https://www.um.poznan.pl/ws/services/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.

• http://www.poznan.pl/mim/public/ws-information/?co=getCategories - lista kategorii
• http://www.poznan.pl/mim/public/ws-information/?co=getObjectsInCategory&... - lista POI w kategorii
• informacje na temat aktualności - https://www.um.poznan.pl/ws/services/news?wsdl Wynikiem metod jest plik XML o zawartości zgodnej z XSD - http://sit-wlkp.eu/xmlrepo/news.xsd. 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

  Udostępnony został również klient, który udostępnia dane poprzez HTTP.

• http://www.poznan.pl/mim/public/ws-information/?co=getCurrentDayNews - lista aktualności z dzisiaj
• http://www.poznan.pl/mim/public/ws-information/?co=getNewsToDate&dateTo=... - lista aktualności
• http://www.poznan.pl/mim/public/ws-information/?co=getNewsFromDate&dateF... - lista aktualności
• http://www.poznan.pl/mim/public/ws-information/?co=getNews&dateFrom=<yyy... - lista aktualności od - do zdefiniowanej daty
• informacja na temat linii komunikacji miejskiej Poznania: https://www.um.poznan.pl/ws/services/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: https://www.um.poznan.pl/ws/services/MPKLines/getBusLines?json=%7B%22typ... 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: https://www.um.poznan.pl/ws/services/MPKLines/getTramLines?json=%7B%22ty... 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

• Pobranie galerii dla danego obiektu
  Zapytanie: http://www.poznan.pl/mim/public/przewodnik/przewodnik_m.html?co=galeria&...
  Przykład: http://www.poznan.pl/mim/public/przewodnik/przewodnik_m.html?co=galeria&...
  Parametry: <object_id> - identyfikator obiektu <lang> - kod wersji językowej (pl, en, ...) Odpowiedź jest zbudowana na podobnej zasadzie jak w przypadku kategorii i obiektów. Po każdym opisie galerii następuje lista należących do niej obrazów.
  Parametry galerii:
  • gallery - Identyfikator galerii
  • instance - Identyfikator instancji
  • name - Nazwa galerii
  • lang - Wybrany język
  • description - Opis galerii

  Parametry obrazu:

  • pic - Identyfikator obrazu
  • instance - Identyfikator instancji
  • name - Opis obrazu
  • shortName - Nazwa obrazu
  • lang - Wybrany język
  • parent - Identyfikator galerii do której należy obraz
  • url - Url do zdjęcia
  • urlSmall - Url do pomniejszonej wersji zdjęcia
• Pobranie listy multimediów dla danego obiektu
  Zapytanie: http://www.poznan.pl/mim/public/przewodnik/przewodnik_m.html?co=media&ob...
  Przykład: http://www.poznan.pl/mim/public/przewodnik/przewodnik_m.html?co=media&ob...
  Parametry:http://bip.um.poznan.pl/ <object_id> - identyfikator obiektu <lang> - kod wersji językowej (pl, en, ...)
  Parametry odpowiedzi - Pierwszy parametr może mieć nazwę równą audio lub wideo, w zależności od typu zawartości. Wartością parametru jest zawsze identyfikator danego pliku dźwiękowego lub wideo.
  • <typ> (audio/wideo) - Identyfikator zawartości
  • name - Nazwa utworu
  • mime - Typ mime
  • file_name - Nazwa pliku
  • file_path - Ścieżka do pliku
  • lang - Wybrany język
  • server - Adres serwera serwującego daną zawartość

 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