Cenogram

Mapa zagrożenia powodziowego (MZP) - dla konkretnej działki, przez API

Sprawdź, czy wybrana działka leży w mapowanej strefie zalewowej i przy jakim scenariuszu powodzi. Zasięgi z map zagrożenia powodziowego, odpowiedź w JSON.

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-01. Kliknij „Uruchom", żeby odpytać na żywo.
{
  "parcel": {
    "id": "69485b4b-2bbe-5081-a90f-bab71dddf189",
    "parcel_id": "326201_1.3025.1/10",
    "parcel_key": "326201_1.3025.1-10"
  },
  "coverage": "covered",
  "as_of": "2026-06-15T21:37:27.643Z",
  "flood_risk": "high",
  "severity_rank": 1,
  "worst_scenario": "river flood, 1-in-10-year",
  "source": "river",
  "depth_class": null,
  "pct_in_zone": "93.42",
  "nearest_zone_m": 0,
  "scenarios": [
    {
      "scenario": "river flood, 1-in-500-year",
      "source": "river",
      "returnPeriod": 500,
      "severity": 3,
      "isLeveeFailure": false,
      "depthClass": null
    },
    {
      "scenario": "river flood, 1-in-10-year",
      "source": "river",
      "returnPeriod": 10,
      "severity": 1,
      "isLeveeFailure": false,
      "depthClass": null
    },
    {
      "scenario": "river flood, 1-in-100-year",
      "source": "river",
      "returnPeriod": 100,
      "severity": 2,
      "isLeveeFailure": false,
      "depthClass": null
    },
    {
      "scenario": "coastal flood, sea-defence failure, 1-in-100-year",
      "source": "coastal",
      "returnPeriod": 100,
      "severity": 2,
      "isLeveeFailure": true,
      "depthClass": null
    },
    {
      "scenario": "coastal flood, 1-in-500-year",
      "source": "coastal",
      "returnPeriod": 500,
      "severity": 3,
      "isLeveeFailure": false,
      "depthClass": null
    },
    {
      "scenario": "coastal flood, 1-in-100-year",
      "source": "coastal",
      "returnPeriod": 100,
      "severity": 2,
      "isLeveeFailure": false,
      "depthClass": null
    }
  ],
  "note": "An empty or covered_no_data result means no mapped flood zone was found to intersect the parcel in our sources — never a statement that the parcel is safe from flooding."
}
Źródło
mapy zagrożenia powodziowego (MZP), Wody Polskie
Zasięg
doliny rzeczne objęte oceną i pas nadmorski, nie cały kraj
Klucz zapytania
bieżący numer działki ewidencyjnej
Odpowiedź
JSON, 4 tokeny za wywołanie

Zapytaj bieżącym numerem działki ewidencyjnej, a dostaniesz zagrożenie powodziowe w JSON: kategorię, listę scenariuszy i udział działki w strefie. MZP to mapa zagrożenia powodziowego i nie ma nic wspólnego z MPZP, czyli miejscowym planem zagospodarowania przestrzennego - przeznaczeń z planów miejscowych w naszym zbiorze nie ma. Pusta odpowiedź mówi tylko tyle, że żadna mapowana strefa nie dotyka tej działki.

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 działka przecina mapowaną strefę. covered_no_data znaczy, że sprawdziliśmy jej obrys i żadna strefa go nie dotyka. not_covered mówi, że działki nie mamy w zbiorze albo nie mamy jej obrysu, a not_computed, że odpowiedzi nie udało się teraz policzyć i warto ponowić za chwilę
as_of datetime | null świeżość naszej odpowiedzi dla tej działki: moment policzenia przecięcia albo data wczytania dopasowanych stref. To nie jest data sporządzenia samych map. Przy covered_no_data wraca null, bo nie ma czego datować
flood_risk string | null high, medium albo low - kategoria najgorszego scenariusza dotykającego działki. Odpowiadają one kolejno powodzi raz na 10, raz na 100 i raz na 500 lat
severity_rank number | null ta sama kategoria liczbą: 1 = high, 2 = medium, 3 = low. Wygodniejsze do sortowania i progów
worst_scenario string | null etykieta najgorszego scenariusza, po angielsku, np. river flood, 1-in-100-year. Składa się z rodzaju zagrożenia, ewentualnej awarii zabezpieczenia i okresu powtarzalności
source string | null rodzaj zagrożenia dla najgorszego scenariusza: river (od rzeki), coastal (od morza) albo infrastructure (budowla piętrząca)
depth_class string | null klasa głębokości zalewu. Zawsze null - w publicznie udostępnianej wersji map głębokość jest obrazem, a nie atrybutem obiektu. Pole zostaje w odpowiedzi, żeby dołożenie tej informacji kiedyś nie łamało kontraktu
pct_in_zone number | null jaki procent powierzchni działki leży w strefie najgorszego scenariusza, od 0 do 100. Pozostałych scenariuszy ta liczba nie sumuje
nearest_zone_m number | null przy działce w strefie zawsze 0. To nie jest zmierzona odległość do najbliższej strefy - pole czeka na sygnał blisko strefy, którego dziś nie liczymy
scenarios array | null wszystkie scenariusze dotykające działki, nie tylko najgorszy. Tu leży odpowiedź na pytanie o konkretne prawdopodobieństwo
scenarios[].scenario / .source string | null etykieta scenariusza i rodzaj zagrożenia, w tej samej konwencji co worst_scenario i source wyżej
scenarios[].returnPeriod number | null okres powtarzalności w latach: 10, 100 albo 500. Pusty przy scenariuszu awarii budowli piętrzącej opisanym jako zdarzenie ekstremalne
scenarios[].severity number kategoria tego jednego scenariusza, w tej samej skali co severity_rank
scenarios[].isLeveeFailure boolean true, gdy scenariusz opisuje zalew po przerwaniu wału albo po awarii zabezpieczenia przeciwsztormowego
scenarios[].depthClass string | null zawsze null, z tego samego powodu co depth_class wyżej
note string zastrzeżenie o zakresie zbioru, 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.

Brak strefy to nie to samo co bezpiecznie

Mapy zagrożenia powodziowego sporządza się dla dolin rzek objętych oceną i dla pasa nadmorskiego, nie dla całego kraju. Nie ma przy nich warstwy mówiącej, gdzie w ogóle prowadzono modelowanie, więc covered_no_data znaczy dokładnie tyle: żadna strefa z naszych źródeł nie dotyka tego obrysu. Dla działki oddalonej od jakiejkolwiek rzeki taka odpowiedź niczego nie rozstrzyga, dla działki w dolinie objętej mapami waży dużo.

Kategoria mówi, jak często, nie jak głęboko

high odpowiada scenariuszowi raz na 10 lat, medium raz na 100 lat, low raz na 500 lat. Działka z high znajduje się w zasięgu wody także przy powodzi, która zdarza się często, i nie jest to ocena głębokości ani strat. Bank, ubezpieczyciel i kupujący pytają zwykle o inny scenariusz, więc czytaj scenarios, a nie samo flood_risk.

Procent dotyczy jednego scenariusza

pct_in_zone liczy udział działki w strefie tego scenariusza, który wypadł najgorzej. Scenariusze łagodniejsze mają większy zasięg i tej liczby nie podnoszą. Działka z trzema procentami w strefie raz na 10 lat potrafi leżeć prawie w całości w strefie raz na 500 lat, a po samym pct_in_zone tego nie widać.

Awaria wału jest osobnym scenariuszem

Część wpisów opisuje zalew po przerwaniu wału albo po awarii budowli piętrzącej - poznasz je po isLeveeFailure i po etykiecie hydraulic-structure failure. Teren za wałem bywa suchy w scenariuszu zwykłym i w strefie w scenariuszu awaryjnym, więc pominięcie tych wpisów zaniża obraz. Scenariusz awaryjny bywa też podany bez okresu powtarzalności: returnPeriod jest wtedy pusty, a etykieta kończy się na extreme event.

Cennik

Jedno wywołanie tego endpointu kosztuje 4 tokeny. Tokeny wracają, gdy działki nie mamy w zbiorze, gdy nie mamy jej obrysu, gdy nie da się teraz policzyć odpowiedzi oraz przy odpowiedziach 400 i 404. Potwierdzony brak strefy 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, te dwa skróty łączy tylko układ liter. MZP to mapa zagrożenia powodziowego, czyli zasięg wody przy zadanym scenariuszu. MPZP to miejscowy plan zagospodarowania przestrzennego, czyli przeznaczenie terenu uchwalone przez gminę. Przeznaczeń z planów miejscowych w naszym zbiorze nie ma i nie zapowiadamy ich: krajowego, hurtowego źródła tych przeznaczeń dziś nie ma, a każda gmina publikuje swoje po swojemu albo wcale. Z warstw planistycznych oddajemy strefy z planów ogólnych gmin (POG).

Nie. covered_no_data mówi, że żadna mapowana strefa nie dotyka obrysu tej działki. Poza dolinami objętymi oceną i poza pasem nadmorskim takiej strefy zwykle po prostu nie ma i brak wpisu jest spodziewany. Zalanie od lokalnego podtopienia, od spływu ze stoku albo od niewydolnej kanalizacji leży poza zakresem tych map.

Nie. depth_class i scenarios[].depthClass są zawsze puste, bo w publicznie udostępnianej wersji map głębokość jest obrazem, a nie atrybutem obiektu. Zostawiliśmy oba pola w odpowiedzi, żeby dołożenie tej informacji kiedyś nie było zmianą łamiącą kontrakt.

4 tokeny. Tokeny wracają, gdy działki nie ma w naszym zbiorze albo nie mamy jej obrysu (not_covered), gdy odpowiedzi nie dało się policzyć (not_computed), oraz przy odpowiedziach 400 i 404. Potwierdzony brak strefy na znanej działce (covered_no_data) jest płatny - sprawdzenie obrysu wobec wszystkich stref kosztuje tyle samo co znalezienie trafienia.

Nie, to API Cenogramu. Mapy zagrożenia powodziowego są publicznie dostępne u wydawcy, 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ć tych danych.

W Claude na numer działki odpowiada narzędzie get_parcel_report. Zwraca jeden raport o działce, w którym sekcja powodziowa jest obok pozostałych danych urzędowych. Całość kosztuje 45 tokenów. Jak podłączyć serwer MCP.

Mapy zagrożenia powodziowego (MZP) sporządza Państwowe Gospodarstwo Wodne Wody Polskie i udostępnia je publicznie oraz bezpłatnie. My trzymamy zasięgi stref i dopasowujemy je do obrysu działki; treści map nie zmieniamy. Kategoria, procent i lista scenariuszy w odpowiedzi to wynik tego dopasowania, a nie cytat z dokumentu źródłowego. Warunki korzystania z naszego API: regulamin.

Zacznij za darmo

400 tokenów na start, potem 50 tygodniowo. Klucz API w 30 sekund, bez karty.