Odległość do najbliższego przystanku (GTFS) - dla konkretnej działki, przez API
Sprawdź, jak daleko z wybranej działki jest do najbliższego przystanku kolei, metra, tramwaju i autobusu. Odpowiedź w JSON, po numerze działki ewidencyjnej. Kolej obejmuje cały kraj, komunikacja miejska dwadzieścia obszarów wymienionych niżej.
Klucz przychodzi mailem, bez karty. Autoryzacja to jeden nagłówek Authorization: Bearer. Poniższe wywołanie możesz uruchomić od razu, bez rejestracji.
{
"parcel": {
"id": "853c5bda-a727-eb9e-55a6-5e626cba5aad",
"parcel_id": "146518_8.0103.24/4",
"parcel_key": "146518_8.0103.24-4"
},
"coverage": "covered",
"as_of": "2026-08-29T09:03:00.189Z",
"rail_distance_m": 735,
"rail_stop_name": "Warszawa Główna",
"metro_distance_m": 195,
"metro_stop_name": "Rondo Daszyńskiego",
"tram_distance_m": 78,
"tram_stop_name": "Muzeum Powstania Warszawskiego",
"bus_distance_m": 44,
"bus_stop_name": "Muzeum Powstania Warszawskiego",
"note": "A mode is present only when a stop is within its cap (rail/metro 3000 m, tram 1500 m, bus 1000 m). A null mode means 'no stop of that mode within cap IN THE FEEDS WE HOLD FOR THIS AREA' — it is never a statement about the city's actual network. We hold open municipal feeds for a subset of cities plus a national rail feed, and the rail feed reaches almost everywhere: in a city whose municipal feed we do not hold, the national rail stop alone still makes the answer `covered`, and tram/bus come back null even where the city runs them. Read a null mode as 'we cannot see it here', not as 'it is not here'. `not_covered` (credit refunded) is reserved for a parcel with no stop of ANY mode nearby — because rail is nationwide, that is rare and is NOT the signal that a municipal feed is missing."
}Zapytaj bieżącym numerem działki ewidencyjnej, a dostaniesz odległość w metrach i nazwę najbliższego przystanku dla czterech rodzajów komunikacji. Ta warstwa jako jedyna w tej rodzinie nie ma pokrycia krajowego: kolej sięga niemal wszędzie, a tramwaj i autobus znamy dla dwudziestu obszarów miejskich wymienionych niżej. Puste pole tram_distance_m opisuje nasze dane dla tej okolicy, a nie sieć tramwajową miasta.
Pola odpowiedzi
Tabela wyjaśnia każde pole z przykładowej odpowiedzi wyżej.
| Pole | Typ | Znaczenie |
|---|---|---|
| parcel | object | tożsamość działki, której dotyczy odpowiedź: id, parcel_id i parcel_key. Przy zapytaniu numerem ewidencyjnym wraca zawsze; przy zapytaniu UUID-em tylko dla kluczy API, OAuth oraz kont płatnych i próbnych |
| coverage | string | cztery stany odpowiedzi. covered znaczy, że przynajmniej jeden rodzaj komunikacji ma przystanek w swoim limicie. covered_no_data znaczy, że sprawdziliśmy działkę i żaden przystanek się w limicie nie zmieścił, choć nasze rozkłady sięgają tej okolicy. not_covered mówi, że działki albo jej obrysu nie mamy, albo w promieniu około 25 kilometrów nie ma u nas żadnego przystanku. not_computed znaczy, że odpowiedzi nie udało się teraz policzyć i warto ponowić za chwilę |
| as_of | datetime | null | świeżość naszej kopii wyniku dla tej działki. To nie jest data obowiązywania rozkładu ani data uruchomienia przystanku. Poza stanem covered wraca null, bo nie ma czego datować |
| rail_distance_m / rail_stop_name | number | null, string | null | odległość w metrach do najbliższego przystanku kolejowego i jego nazwa z rozkładu. Limit dla kolei to 3000 m; powyżej niego oba pola wracają puste |
| metro_distance_m / metro_stop_name | number | null, string | null | to samo dla metra, limit 3000 m. W praktyce wypełnione przy działkach w Warszawie i pod nią, bo metro ma w Polsce jedno miasto |
| tram_distance_m / tram_stop_name | number | null, string | null | to samo dla tramwaju, limit 1500 m. Poza obszarami z listy pokrycia oba pola wracają puste niezależnie od tego, czy miasto ma tramwaje |
| bus_distance_m / bus_stop_name | number | null, string | null | to samo dla autobusu, limit 1000 m. Autobusy podmiejskie i dalekobieżne spoza rozkładów miejskich nie trafiają do tego pola |
| note | string | zastrzeżenie o zasięgu naszych rozkładów i o znaczeniu pustego rodzaju, dołączane do każdej odpowiedzi. Po angielsku, bo jest częścią kontraktu publicznego API i mają je wszyscy klienci |
Jak czytać odpowiedź
Miejsca, w których tę odpowiedź łatwo przeczytać źle.
Komunikacja miejska kończy się na liście dwudziestu obszarów
Rozkład kolejowy mamy dla całego kraju, więc rail_distance_m bywa wypełnione niemal wszędzie. Komunikację miejską mamy dla Bydgoszczy, Elbląga, Ełku, Gdańska, Gdyni, Giżycka, Gorzowa Wielkopolskiego, Kielc, Krakowa, Lublina, Łomży, Poznania, Radomia, Szczecina, Świnoujścia, Torunia, Warszawy, Wejherowa, Wrocławia oraz metropolii górnośląsko-zagłębiowskiej (GZM). Stan na 1 września 2026 roku. Dla działki spoza tej listy tram_distance_m i bus_distance_m wracają puste, choć miasto może mieć i tramwaje, i autobusy. Nowe miasta dochodzą do zbioru bez żadnej zmiany po Twojej stronie.
not_covered nie jest sygnałem braku rozkładu miejskiego
To najczęstsza pomyłka przy tej warstwie. not_covered dostajesz dopiero wtedy, gdy w promieniu około 25 kilometrów nie ma u nas żadnego przystanku, a przy kolei rozciągniętej na cały kraj zdarza się to rzadko. Działka w mieście, którego rozkładu miejskiego nie mamy, odpowie covered po samym przystanku kolejowym, z pustym tramwajem i autobusem. Braku danych miejskich szukaj więc w pustych polach rodzajów i na liście wyżej, nigdy w coverage.
Każdy rodzaj ma własny limit i swoje puste pole
Przystanek trafia do odpowiedzi tylko wtedy, gdy mieści się w limicie swojego rodzaju: 3000 m dla kolei i metra, 1500 m dla tramwaju, 1000 m dla autobusu. Tramwaj oddalony o 1600 metrów wróci jako puste pole, a nie jako 1600, więc z tej odpowiedzi nie da się odczytać, jak daleko jest najbliższy przystanek poza limitem. Podana liczba to odległość w linii prostej między obrysem działki a przystankiem: rzeka, tory albo ogrodzenie potrafią wydłużyć realne dojście o kilkaset metrów.
Puste metro poza Warszawą nie jest luką w danych
Metro ma w Polsce jedno miasto, więc metro_distance_m wypełnia się przy działkach w Warszawie i w jej sąsiedztwie, a wszędzie indziej wraca puste. Kolej podmiejska w rejonie Warszawy liczy się u nas jako kolej i trafia do pola kolejowego, nie do metra. Jeśli budujesz próg dostępności, oprzyj go na kolei, tramwaju i autobusie, bo metro daje sygnał tylko dla jednego rynku.
Przystanek pod domem to nie to samo co dobre połączenie
Z rozkładów bierzemy położenie przystanków i rodzaj obsługującej je komunikacji. Godzin odjazdów, liczby kursów ani numerów linii w odpowiedzi nie ma i nie zapowiadamy ich. Dwie działki po 200 metrów od przystanku autobusowego potrafią mieć zupełnie inną obsługę: przy jednej autobus jeździ co osiem minut, przy drugiej cztery razy dziennie. Traktuj tę warstwę jako pierwsze przybliżenie dostępności i sprawdź rozkład u organizatora transportu, zanim wciągniesz ją do wyceny jako atut.
Cennik
Jedno wywołanie tego endpointu kosztuje 4 tokeny. Tokeny wracają, gdy działki nie mamy w zbiorze, gdy nie znamy jej obrysu, gdy w promieniu około 25 kilometrów nie ma żadnego przystanku z naszych źródeł, gdy odpowiedzi nie da się teraz policzyć oraz przy odpowiedziach 400 i 404. Potwierdzony brak przystanku w limitach odległości, na działce w zasięgu naszych rozkładów, jest płatny.
Free
Na próbę
400 tokenów na start, potem 50 tygodniowo
to 100 wywołań tego endpointu
- -Wszystkie endpointy
- -Serwer MCP
- -Bez karty
Standard
Dla rzeczoznawców
60,27 zł brutto
2 000 tokenów / mies.
to 500 wywołań tego endpointu
- -Wszystko z Free
- -2 000 tokenów API + MCP
- -Pełny dostęp do wyszukiwarki
Professional
Dla programistów i mniejszych zespołów
121,77 zł brutto
5 000 tokenów / mies.
to 1250 wywołań tego endpointu
- -Wszystko ze Standard
- -5 000 tokenów API + MCP
- -Pełny dostęp do wyszukiwarki
Advanced
Dla firm wycenowych i deweloperów
367,77 zł brutto
25 000 tokenów / mies.
to 6250 wywołań tego endpointu
- -Wszystko z Professional
- -Redystrybucja: dane w Twoim produkcie lub usłudze (z atrybucją Cenogram)
- -Wsparcie e-mail: odpowiedź w 24 h
Business
Dla proptech i większych zespołów
1843,77 zł brutto
200 000 tokenów / mies.
to 50 000 wywołań tego endpointu
- -Wszystko z Advanced
- -White-label: atrybucja nie jest wymagana
- -Wsparcie e-mail: odpowiedź w 8 h
Przejście na wyższy plan zastępuje obecną subskrypcję, a rozliczenie rusza od nowa
Częste pytania
Nie. Odpowiedź niesie odległość i nazwę najbliższego przystanku dla czterech rodzajów komunikacji. Godzin odjazdów, liczby kursów i numerów linii nie zapisujemy, więc nie ma ich w żadnym planie taryfowym. Dostępność liczona z samej odległości pomija różnicę między autobusem co osiem minut a czterema kursami dziennie.
Bydgoszcz, Elbląg, Ełk, Gdańsk, Gdynia, Giżycko, Gorzów Wielkopolski, Kielce, Kraków, Lublin, Łomża, Poznań, Radom, Szczecin, Świnoujście, Toruń, Warszawa, Wejherowo, Wrocław oraz metropolia górnośląsko-zagłębiowska (GZM), czyli dwadzieścia obszarów, stan na 1 września 2026 roku. Kolej obejmuje cały kraj niezależnie od tej listy. Kolejne miasta dochodzą wtedy, gdy potwierdzimy warunki ponownego wykorzystywania ich rozkładów.
Nie. Puste pole rodzaju znaczy, że w limicie odległości nie ma przystanku tego rodzaju w rozkładach, które mamy dla tej okolicy. Dla miasta spoza listy pokrycia tramwaj i autobus wracają puste zawsze, także w centrum. Dla miasta z listy puste pole mówi już o samej działce i wtedy jest informacją.
4 tokeny. Tokeny wracają, gdy działki nie ma w naszym zbiorze albo nie znamy jej obrysu, gdy w promieniu około 25 kilometrów nie ma u nas żadnego przystanku (not_covered), gdy odpowiedzi nie dało się policzyć (not_computed), oraz przy odpowiedziach 400 i 404. Sprawdzona działka bez przystanku w limitach (covered_no_data) jest płatna, bo sprawdzenie wykonaliśmy.
Nie, to API Cenogramu. Rozkłady w formacie GTFS miasta udostępniają same i są bezpłatne. My scalamy z nich położenie przystanków i oddajemy odległość do najbliższego z nich pod bieżącym numerem działki, obok pozostałych danych urzędowych, więc nie musisz sam pobierać ani odświeżać kilkudziesięciu plików z rozkładami.
W Claude na numer działki odpowiada narzędzie get_parcel_report. Zwraca jeden raport o działce, w którym sekcja o dostępie do komunikacji idzie razem z pozostałymi danymi urzędowymi, i kosztuje 45 tokenów. Na numer transakcji odpowiada narzędzie get_transaction_layer z parametrem layer=transit. Jak podłączyć serwer MCP.
Rozkłady w formacie GTFS publikują organizatorzy transportu w miastach oraz zarządca infrastruktury kolejowej, a warunki ponownego wykorzystywania różnią się od miasta do miasta. Rozkłady miejskie mamy na licencji CC0 1.0 albo CC BY, a rozkład kolejowy na CC BY 4.0 razem z warunkami PKP Polskie Linie Kolejowe S.A. Wydawców poszczególnych rozkładów i warunki ich ponownego wykorzystywania podajemy na stronie źródeł danych. Dane przetwarzamy: bierzemy z rozkładów położenie przystanków i rodzaj obsługującej je komunikacji, liczymy odległość do najbliższego przystanku każdego rodzaju i nie publikujemy godzin odjazdów. Pełne teksty licencji: CC0 1.0, CC BY 4.0. Warunki korzystania z naszego API: regulamin.
Zacznij za darmo
400 tokenów na start, potem 50 tygodniowo. Klucz API w 30 sekund, bez karty.