Obiekty uciążliwe w otoczeniu (BDOT10k) - odległości dla konkretnej działki, przez API
Sprawdź, jak daleko od wybranej działki jest najbliższy cmentarz, składowisko odpadów, oczyszczalnia ścieków, teren przemysłowo-składowy, duży zakład przemysłowy i ferma hodowlana. Sześć odległości w metrach, odpowiedź w JSON.
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": "14e888aa-b9b9-9c9f-135f-6f43f7ba3c6a",
"parcel_id": "141704_4.0015.2/8",
"parcel_key": "141704_4.0015.2-8"
},
"coverage": "covered",
"as_of": "2026-09-03T21:33:10.807Z",
"cemetery_distance_m": 404.4,
"landfill_distance_m": 2040.9,
"sewage_treatment_distance_m": 1975.3,
"industrial_area_distance_m": 0,
"industrial_plant_distance_m": 70.3,
"livestock_farm_distance_m": 1767.4,
"power_line_hv_distance_m": 384.5,
"power_line_ehv_distance_m": null,
"note": "Distances are approximate, measured from the parcel boundary; a null distance means nothing of that kind within the category's search radius (cemetery 1 km, landfill 3 km, sewage treatment 2 km, industrial-warehouse 1 km, large industrial plant 3 km, intensive livestock farm 3 km, high-voltage overhead power line 1 km, extra-high-voltage overhead power line 1 km), not a guarantee of absence."
}Zapytaj bieżącym numerem działki ewidencyjnej, a dostaniesz osiem odległości w metrach, liczonych od granicy działki do najbliższego obiektu w każdej kategorii. Puste pole mówi, że w promieniu przypisanym do tej kategorii niczego takiego nie znaleźliśmy, i nie jest zapewnieniem, że w okolicy tego nie ma. Sama odległość opisuje położenie, a o tym, jak bardzo obiekt daje się we znaki, decydują wiatr, ukształtowanie terenu i to, co obiekt faktycznie robi.
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 | stan odpowiedzi. covered znaczy, że działkę sprawdziliśmy, i tak wraca też wtedy, gdy wszystkie osiem pól jest pustych. not_covered mówi, że działki nie mamy w zbiorze albo nie znamy jej obrysu, a not_computed, że odpowiedzi nie udało się teraz policzyć i warto ponowić za chwilę. Czwarty stan rodziny, covered_no_data, przy tej warstwie praktycznie się nie pojawia - sprawdzenie kończy się wynikiem nawet wtedy, gdy w zasięgu nie ma niczego |
| as_of | datetime | null | kiedy policzyliśmy zapisany wynik dla tej działki. Gdy liczymy odpowiedź na poczekaniu, wraca null, bo nie ma czego datować. To nie jest data aktualizacji samych zbiorów źródłowych |
| cemetery_distance_m | number | null | metry od granicy działki do najbliższego cmentarza. Puste, gdy w promieniu 1 km cmentarza nie znaleźliśmy |
| landfill_distance_m | number | null | metry do najbliższego składowiska odpadów albo terenu zagospodarowania odpadów, razem ze złomowiskami i terenami utylizacji. Promień 3 km |
| sewage_treatment_distance_m | number | null | metry do najbliższej oczyszczalni ścieków. Promień 2 km |
| industrial_area_distance_m | number | null | metry do najbliższego terenu zabudowy przemysłowo-składowej. To obszar w mapie topograficznej, a nie konkretny zakład, więc może na nim pracować huta i może leżeć odłogiem hala. Promień 1 km |
| industrial_plant_distance_m | number | null | metry do najbliższego dużego zakładu przemysłowego z rejestru E-PRTR, czyli takiego, który przekracza progi sprawozdawcze dla uwolnień zanieczyszczeń. Promień 3 km |
| livestock_farm_distance_m | number | null | metry do najbliższej fermy z tego samego rejestru: chów zwierząt w skali, która wymaga pozwolenia zintegrowanego. Promień 3 km |
| power_line_hv_distance_m | number | null | metry do najbliższej napowietrznej linii wysokiego napięcia (110 kV). Liczone do osi linii, nie do słupa. Promień 1 km |
| power_line_ehv_distance_m | number | null | to samo dla linii najwyższych napięć (220 i 400 kV). W miastach zwykle puste, bo sieć przesyłowa omija zabudowę. Promień 1 km. Linie średniego i niskiego napięcia do tej warstwy nie wchodzą, tak samo jak stacje i szerokość pasa służebności |
| note | string | zastrzeżenie o zakresie odpowiedzi razem z promieniem każdej kategorii, 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.
Puste pole i zero to dwie różne odpowiedzi
0 znaczy, że działka nachodzi na obiekt albo styka się z nim granicą. Puste pole znaczy, że w promieniu przypisanym do tej kategorii nic nie trafiliśmy. Promienie są różne: 1 km dla cmentarza i terenu przemysłowo-składowego, 2 km dla oczyszczalni, 3 km dla składowiska, zakładu i fermy. Składowisko oddalone o 3,5 km i cmentarz oddalony o 1,2 km dają w odpowiedzi to samo puste pole, choć w terenie znaczą co innego.
Sześć liczb pochodzi z dwóch różnych rodzajów zbiorów
Cmentarze, składowiska, oczyszczalnie i tereny przemysłowo-składowe są obszarami z mapy topograficznej, więc odległość prowadzi do granicy takiego obszaru. Zakłady i fermy pochodzą z rejestru instalacji, do którego wchodzą tylko te przekraczające progi sprawozdawcze. Warsztat na skraju wsi ani niewielka obora nigdy się w nim nie znajdą, więc puste industrial_plant_distance_m opisuje rejestr, a nie ciszę w okolicy.
Odległość liczymy od granicy działki, nie od domu
Przy działce hektarowej dom potrafi stać kilkaset metrów dalej niż jej najbliższy narożnik, a odpowiedź poda ten narożnik. Działka przylegająca do terenu przemysłowo-składowego dostanie 0 nawet wtedy, gdy zabudowa mieszkalna jest na jej przeciwległym końcu. Przy dużych działkach warto więc czytać tę liczbę razem z obrysem i z położeniem budynków.
Bliskość nie przekłada się wprost na uciążliwość
Zapach z fermy niesie się z wiatrem i przy stałej róży wiatrów działka po jednej stronie żyje inaczej niż działka po drugiej, mimo tej samej liczby w odpowiedzi. Skarpa, las albo linia zabudowy potrafią wygasić hałas z terenu przemysłowego. Warstwa mówi, gdzie obiekt jest, i to jest sygnał do sprawdzenia okolicy, a nie ocena, jak się w niej mieszka.
Te dane zmieniają się wolno, a nowy obiekt pojawia się w nich z opóźnieniem
Mapa topograficzna aktualizuje się w cyklu liczonym w latach, rejestr instalacji w cyklu rocznym. Nowe składowisko albo nowa ferma potrafią więc działać wcześniej, niż zobaczy je nasza kopia. Pole as_of mówi, kiedy policzyliśmy wynik dla tej działki, i bywa puste, gdy liczymy go na poczekaniu. Planowanej inwestycji ta warstwa nie pokaże w żadnym wypadku - do tego służą pozwolenia na budowę.
Cennik
Jedno wywołanie tego endpointu kosztuje 4 tokeny. Tokeny wracają, gdy działki nie mamy w zbiorze, gdy nie znamy jej obrysu, gdy odpowiedzi nie da się teraz policzyć oraz przy odpowiedziach 400 i 404. Sprawdzona działka jest płatna także wtedy, gdy wszystkie osiem odległości wraca pustych - to też jest wynik sprawdzenia.
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, to API Cenogramu. Baza BDOT10k jest publiczna i można ją pobrać u wydawcy. My wybieramy z niej kategorie uciążliwe, dokładamy rejestr zakładów i ferm i oddajemy wynik jako REST/JSON pod bieżącym numerem działki, obok pozostałych danych urzędowych, więc nie musisz sam wczytywać ani odświeżać tych zbiorów w skali kraju.
Nie. Puste pole mówi, że w promieniu przypisanym do tej kategorii nic nie trafiliśmy, a promienie są różne: 1 km dla cmentarza i terenu przemysłowo-składowego, 2 km dla oczyszczalni, 3 km dla składowiska, zakładu i fermy. Cmentarz oddalony o 1,3 km wypada poza swój promień i pole zostaje puste. Do tego dochodzi zakres samych zbiorów: rejestr zakładów obejmuje instalacje przekraczające progi sprawozdawcze, więc mniejsze obiekty nie pojawią się w nim wcale.
Nie. Nazw, adresów ani identyfikatorów zakładów i ferm nie wystawiamy na żadnym planie taryfowym - odpowiedź podaje odległość w metrach i nic ponadto. Powód jest dwojaki: część takich obiektów prowadzą osoby fizyczne w ramach działalności gospodarczej, a sama odległość wystarcza do oceny działki.
4 tokeny. Tokeny wracają, gdy działki nie ma w naszym zbiorze albo nie znamy jej obrysu (not_covered), gdy odpowiedzi nie dało się policzyć (not_computed), oraz przy odpowiedziach 400 i 404. Sprawdzona działka jest płatna również wtedy, gdy wszystkie osiem pól wraca pustych, bo sprawdzenie wobec każdej kategorii wykonaliśmy tak samo jak przy trafieniu.
Nie. Odpowiedź podaje odległość do najbliższego obiektu w ośmiu kategoriach i nic o samym oddziaływaniu nie mówi. Pomiarów imisji ani stężeń nie prowadzimy i nie planujemy - do tego są sieci pomiarowe inspekcji ochrony środowiska. Warstwa przydaje się na etapie sortowania działek i typowania tych, które trzeba obejrzeć na miejscu.
W Claude na numer działki odpowiada narzędzie get_parcel_report. Zwraca jeden raport o działce, w którym sekcja o otoczeniu 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=surroundings, które podaje odległości dla każdej działki z aktu notarialnego. Jak podłączyć serwer MCP.
Obiekty topograficzne z bazy BDOT10k udostępnia bezpłatnie Główny Urząd Geodezji i Kartografii, w ramach państwowego zasobu geodezyjnego i kartograficznego, na warunkach prawa geodezyjnego i kartograficznego. Źródło wskazujemy w tej nocie. Rejestr zakładów przemysłowych i ferm (E-PRTR) prowadzi Główny Inspektorat Ochrony Środowiska i udostępnia go na licencji Creative Commons Uznanie autorstwa 4.0 Międzynarodowe (CC BY 4.0). Dane zmodyfikowaliśmy: powiązaliśmy obiekty z działkami ewidencyjnymi i ograniczyliśmy wynik do odległości w metrach. Nazw, adresów ani identyfikatorów zakładów i ferm nie wystawiamy w odpowiedzi. Pełny tekst licencji: 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.