Mapa osuwisk i terenów zagrożonych ruchami masowymi (SOPO) - dla konkretnej działki, przez API
Sprawdź, czy działka wchodzi w granice zmapowanego osuwiska albo terenu zagrożonego ruchami masowymi ziemi. Odpowiedź w JSON, po numerze działki ewidencyjnej.
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": "f541293d-5135-574b-89a3-95034ef85204",
"parcel_id": "180702_5.0010.24/7",
"parcel_key": "180702_5.0010.24-7"
},
"coverage": "covered",
"as_of": "2026-07-02T22:04:08.814Z",
"landslide_risk": "landslide",
"severity_rank": 1,
"pct_in_zone": "26.60",
"zones": [
{
"kind": "landslide",
"source_version_date": "2010-09-04"
},
{
"kind": "landslide",
"source_version_date": "2010-09-20"
},
{
"kind": "landslide",
"source_version_date": "2010-09-22"
},
{
"kind": "landslide",
"source_version_date": "2010-09-25"
},
{
"kind": "threatened",
"source_version_date": "2010-09-26"
},
{
"kind": "threatened",
"source_version_date": "2012-06-18"
},
{
"kind": "threatened",
"source_version_date": "2012-07-06"
}
],
"note": "An intersection indicates the parcel overlaps a mapped hazard area, not that the parcel is itself a landslide. Absence of a match is never asserted as 'safe' — mapping coverage is regional (surveys concentrate on the mountainous south), so in a lowland region an empty result may mean the area was never surveyed rather than that it is stable."
}
Zapytaj bieżącym numerem działki ewidencyjnej, a dostaniesz klasę zagrożenia osuwiskowego w JSON: zmapowane osuwisko albo teren zagrożony ruchami masowymi, udział powierzchni działki w zasięgu i listę dopasowanych zasięgów. Przecięcie mówi, że obrys działki wchodzi w granice zmapowanego zagrożenia, a nie że działka sama jest osuwiskiem. Brak dopasowania nie jest orzeczeniem o stabilności gruntu i nie zastępuje opinii geologicznej.
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 obrys działki przecina zmapowany zasięg. covered_no_data znaczy, że sprawdziliśmy obrys i żaden zasięg go nie dotyka. not_covered mówi, że działki albo jej obrysu nie mamy, a not_computed, że odpowiedzi nie udało się teraz policzyć i warto ponowić za chwilę |
| as_of | datetime | null | z kiedy pochodzi nasz wynik dla tej działki: moment policzenia przecięcia albo data wczytania dopasowanych zasięgów. To nie jest data kartowania terenu. Poza stanem covered wraca null, bo nie ma czego datować |
| landslide_risk | string | null | landslide przy zmapowanym osuwisku, threatened przy terenie zagrożonym ruchami masowymi ziemi. Gdy działkę dotykają obie klasy, wraca cięższa. null przy każdej pustej odpowiedzi |
| severity_rank | number | null | ta sama klasa liczbą: 1 dla landslide, 2 dla threatened. Wygodniejsze do sortowania działek w zestawieniu i do progów |
| pct_in_zone | string | null | jaka część powierzchni działki mieści się w zasięgach klasy cięższej, w procentach z dwoma miejscami po przecinku (w JSON jako tekst). Zasięgów klasy łagodniejszej ta liczba nie dolicza |
| zones | array | null | wszystkie zasięgi dopasowane do działki, po jednej pozycji na parę rodzaju i daty wersji. Tu widać, czy pod jedną klasą kryje się kilka odrębnych zasięgów |
| zones[].kind | string | null | rodzaj tego zasięgu: landslide albo threatened. Lista bywa mieszana, bo działka potrafi wejść w oba naraz |
| zones[].source_version_date | date | null | data wersji rekordu w źródle. Mówi, kiedy rekord został zapisany w tej postaci, i nie jest datą badania terenu ani obserwacji osuwiska |
| note | string | zastrzeżenie o zakresie odpowiedzi, dołączane do każdej z nich. 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.
Pusta odpowiedź nie mówi „stabilnie”
Kartowanie osuwiskowe skupia się na południu kraju i nie objęło Polski po równo. Do tego zbiór nie niesie warstwy mówiącej, gdzie kartowanie w ogóle prowadzono, więc covered_no_data znaczy dokładnie tyle: żaden zasięg z naszych źródeł nie dotyka tego obrysu. Dla działki w Karpatach taka odpowiedź waży dużo, dla działki na nizinie może opisywać teren, którego nikt nie kartował.
Osuwisko i teren zagrożony to dwie różne wiadomości
landslide znaczy, że działka wchodzi w granice zmapowanego osuwiska. threatened znaczy, że wchodzi w granice terenu zagrożonego ruchami masowymi ziemi, czyli obszaru, na którym takiego ruchu jeszcze nie odnotowano, a warunki mu sprzyjają. Kupujący i rzeczoznawca czytają te dwa stany inaczej, więc nie sprowadzaj ich do jednej flagi „zagrożenie”. Gdy działkę dotykają obie klasy, w landslide_risk widzisz cięższą, a pełny obraz zostaje w zones.
source_version_date to nie data badania terenu
Przy każdym zasięgu podajemy datę wersji rekordu w źródle. Świeża data znaczy, że rekord został wtedy zapisany w tej postaci, a nie że ktoś wtedy był na miejscu i sprawdzał zbocze. Wiek samej oceny osuwiskowej z tego pola nie wynika, więc nie buduj na nim reguły „dane sprzed pięciu lat odrzucamy”. Świeżość naszej kopii mówi osobne pole as_of.
Procent liczy tylko klasę cięższą
pct_in_zone mierzy udział powierzchni działki w zasięgach tej klasy, która wypadła najgorzej. Działka z dwoma procentami w zmapowanym osuwisku potrafi leżeć prawie w całości w terenie zagrożonym, a po samej tej liczbie tego nie widać. Gdy potrzebujesz obu obrazów, rozdziel zones po kind i traktuj procent jako opis cięższej klasy, nie całej ekspozycji działki.
Granice zasięgów są rysowane w skali 1:10 000
Zasięgi pochodzą z map kartowanych w skali 1:10 000, a my dopasowujemy je do obrysu działki. Przy tej skali linia zasięgu bywa grubsza niż różnice, o które toczy się spór na granicy działki: działka dotknięta rogiem dostanie trafienie z niskim pct_in_zone. Traktuj niski procent jako sygnał do sprawdzenia mapy, nie jako pomiar powierzchni zagrożonej.
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. Potwierdzony brak zasięgu na znanej działce 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, to API Cenogramu. System Osłony Przeciwosuwiskowej prowadzi PIG-PIB i udostępnia zasięgi publicznie, razem z przeglądarką na mapie. My oddajemy te same zasięgi 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ć tego zbioru.
Nie. covered_no_data mówi, że żaden zmapowany zasięg nie dotyka obrysu tej działki. Kartowanie objęło przede wszystkim południe kraju, a w zbiorze nie ma warstwy mówiącej, gdzie je prowadzono, więc pusta odpowiedź poza rejonami skartowanymi nie rozstrzyga o stabilności gruntu. O tym rozstrzyga geolog na miejscu.
landslide odnosi się do zmapowanego osuwiska, threatened do terenu zagrożonego ruchami masowymi ziemi. Pierwsze opisuje zjawisko już odnotowane, drugie warunki, które mu sprzyjają. Gdy obie klasy dotykają działki, w landslide_risk i severity_rank zwracamy cięższą, a obie zostają widoczne w zones.
Nie. Sprawdzamy, czy obrys działki przecina zasięg zmapowanego zagrożenia, a pct_in_zone podaje, jaka część powierzchni działki w nim leży. Przy kilku procentach chodzi zwykle o skraj działki. Sam fakt przecięcia nie mówi też nic o tym, gdzie na działce stoi budynek ani gdzie planujesz budowę.
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ę teraz policzyć (not_computed), oraz przy odpowiedziach 400 i 404. Potwierdzony brak zasięgu na znanej działce (covered_no_data) jest płatny, bo sprawdzenie obrysu wobec wszystkich zasięgów kosztuje tyle samo co znalezienie trafienia.
W Claude na numer działki odpowiada narzędzie get_parcel_report. Zwraca jeden raport o działce, w którym sekcja osuwiskowa 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=landslide. Jak podłączyć serwer MCP.
Autorem zbioru zasięgów osuwisk i terenów zagrożonych ruchami masowymi ziemi jest Państwowy Instytut Geologiczny - Państwowy Instytut Badawczy (PIG-PIB), który prowadzi System Osłony Przeciwosuwiskowej (SOPO) i udostępnia te dane na licencji Creative Commons Uznanie autorstwa 4.0 Międzynarodowe (CC BY 4.0). Dane zmodyfikowaliśmy: powiązaliśmy zasięgi z działkami ewidencyjnymi, policzyliśmy udział powierzchni działki w zasięgach klasy cięższej i ograniczyliśmy opis każdego zasięgu do rodzaju oraz daty wersji rekordu. Odpowiedź ma charakter poglądowy i nie zastępuje opinii geologicznej ani rozstrzygnięcia urzędu. 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.