Cenogram

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.

Zobacz dokumentację

Klucz przychodzi mailem, bez karty. Autoryzacja to jeden nagłówek Authorization: Bearer. Poniższe wywołanie możesz uruchomić od razu, bez rejestracji.

GET
Przykładowa odpowiedź - pobrane 2026-09-02. Kliknij „Uruchom", żeby odpytać na żywo.
{
  "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."
}
Źródło
System Osłony Przeciwosuwiskowej (SOPO), PIG-PIB
Zakres
kartowanie skupione na południu kraju, nie po równo w całej Polsce
Klucz zapytania
bieżący numer działki ewidencyjnej
Odpowiedź
JSON, 4 tokeny za wywołanie

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.

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ę

0 zł

400 tokenów na start, potem 50 tygodniowo

to 100 wywołań tego endpointu

  • -Wszystkie endpointy
  • -Serwer MCP
  • -Bez karty
Najpopularniejszy

Standard

Dla rzeczoznawców

49 zł netto/miesiąc

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

99 zł netto/miesiąc

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

299 zł netto/miesiąc

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

1499 zł netto/miesiąc

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

Ceny netto, +23% VAT · Faktura VAT na żądanie · Bez umów · Free bez karty
Visa Mastercard BLIK Apple Pay Google Pay

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.