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.
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": "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."
}
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.
| 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 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ę
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, 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.