Tereny górnicze i główne zbiorniki wód podziemnych (MIDAS, GZWP) - dla konkretnej działki, przez API
Sprawdź, czy wybrana działka leży w terenie górniczym i czy obejmuje ją zasięg głównego zbiornika wód podziemnych. 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": "019b5016-af17-ca7a-a2c4-e304d08515f9",
"parcel_id": "302112_5.0034.28/2",
"parcel_key": "302112_5.0034.28-2"
},
"coverage": "covered",
"as_of": "2026-08-25T19:12:47.595Z",
"mining_status": "active",
"mineral_class": "surface",
"mining_overlap_pct": "100.00",
"mining_terrains": [
{
"name": "Zbierkowo TB",
"status": "active",
"mineral_class": "surface",
"oversight_authority": "Okręgowy Urząd Górniczy - Poznań",
"valid_until": "2067-05-31",
"revoked_on": null,
"overlap_pct": 100
},
{
"name": "Borówko KR",
"status": "former",
"mineral_class": "surface",
"oversight_authority": "Okręgowy Urząd Górniczy - Poznań",
"valid_until": "2010-12-31",
"revoked_on": "2010-10-04",
"overlap_pct": 26.35
},
{
"name": "Borówko",
"status": "former",
"mineral_class": "surface",
"oversight_authority": "Okręgowy Urząd Górniczy - Poznań",
"valid_until": "2005-12-31",
"revoked_on": "2001-07-26",
"overlap_pct": 25.28
},
{
"name": "Borówko I-C",
"status": "former",
"mineral_class": "surface",
"oversight_authority": "Okręgowy Urząd Górniczy - Poznań",
"valid_until": "2015-12-31",
"revoked_on": "2012-08-22",
"overlap_pct": 0.26
},
{
"name": "Borówko KR A",
"status": "former",
"mineral_class": "surface",
"oversight_authority": "Okręgowy Urząd Górniczy - Poznań",
"valid_until": "2017-12-31",
"revoked_on": "2012-12-20",
"overlap_pct": 0.05
}
],
"groundwater_status": "documented",
"groundwater_overlap_pct": "100.00",
"groundwater_bodies": [
{
"number": 143,
"name": "Subzbiornik Inowrocław - Gniezno",
"documentation_status": "documented",
"documented_year": 2013,
"depth_from_m": 90,
"medium_type": "porous",
"overlap_pct": 100
},
{
"number": 144,
"name": "Dolina Kopalna Wielkopolska",
"documentation_status": "documented",
"documented_year": 2011,
"depth_from_m": 15,
"medium_type": "porous",
"overlap_pct": 100
}
],
"note": "An intersection indicates the parcel overlaps a mapped mining terrain (a legally defined zone of anticipated mining influence) or a major groundwater reservoir — not that either constrains the parcel. A reservoir's extent alone imposes no legal restriction; a restriction would come from an established protection zone, which is not published here. A mining-terrain record is an advisory signal whose mapped location is approximate — verify it with the competent mining-supervision authority (oversight_authority names which). Absence of a match is never asserted as 'safe': the mining register covers concession areas, so historic or shallow workings predating it may not appear, and an absent reservoir does not mean there is no groundwater beneath the parcel."
}Zapytaj bieżącym numerem działki ewidencyjnej, a dostaniesz dwa niezależne sygnały w JSON: teren górniczy obejmujący działkę i zasięg głównego zbiornika wód podziemnych. Zasięg zbiornika sam z siebie niczego nie zakazuje, a wpis o terenie górniczym jest sygnałem do sprawdzenia u okręgowego urzędu górniczego, nie rozstrzygnięciem. Brak trafienia nie jest orzeczeniem, że pod działką nic nie ma.
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 trafił przynajmniej jeden z dwóch wymiarów. covered_no_data znaczy, że sprawdziliśmy obrys działki i nie trafił żaden. not_covered mówi, że działki albo jej obrysu nie mamy, albo nie mamy jeszcze wczytanych danych źródłowych, 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 obiektów. To nie jest data z rejestru - daty samych obiektów wracają osobno, w valid_until, revoked_on i documented_year. Poza stanem covered wraca null, bo nie ma czego datować |
| mining_status | string | null | active, gdy działkę obejmuje teren górniczy czynny, albo former, gdy tylko teren zniesiony. Gdy działka nie dotyka żadnego terenu górniczego, to pole i pozostałe pola mining_* są puste, a odpowiedź nadal może nieść trafienie po stronie zbiornika |
| mineral_class | string | null | rodzaj kopaliny sprowadzony do czterech klas: subsidence (eksploatacja podziemna węgla, rud i soli), surface (kruszywa, kamień i kopaliny ilaste wydobywane odkrywkowo), fluid (wydobycie otworowe gazu, ropy, solanek i wód leczniczych), other przy kopalinie, której nie zaklasyfikowaliśmy. Skalar podaje klasę najcięższą spośród terenów dotykających działki |
| mining_overlap_pct | number | null | jaki procent powierzchni działki leży w terenach górniczych łącznie, od 0 do 100, z dwoma miejscami po przecinku |
| mining_terrains | array | null | poszczególne tereny górnicze dotykające działki, od najcięższego przypadku. Lista jest przycięta do pięciu pozycji, a odpowiedź nie podaje, ile ich było łącznie |
| mining_terrains[].name / .status | string | null | nazwa terenu górniczego z rejestru oraz jego status, active albo former, tak samo jak w skalarze wyżej |
| mining_terrains[].mineral_class | string | null | klasa kopaliny tego jednego terenu, w tej samej czterowartościowej skali co mineral_class |
| mining_terrains[].oversight_authority | string | null | organ nadzoru górniczego właściwy dla tego terenu. To pod ten adres idzie się po wiążące potwierdzenie, więc pole jest w odpowiedzi po to, żeby było gdzie zapytać |
| mining_terrains[].valid_until / .revoked_on | date | null | data ważności terenu górniczego oraz data jego zniesienia. revoked_on wypełniamy przy terenach zniesionych; przy czynnych zostaje puste |
| mining_terrains[].overlap_pct | number | null | jaki procent powierzchni działki leży w tym jednym terenie. Tereny potrafią na siebie zachodzić, więc suma pozycji nie musi się zgadzać z mining_overlap_pct |
| groundwater_status | string | null | documented, gdy działkę obejmuje zbiornik udokumentowany, albo undocumented, gdy tylko nieudokumentowany. Puste, gdy działka leży poza zasięgiem zbiorników - i wtedy pozostałe pola groundwater_* też są puste |
| groundwater_overlap_pct | number | null | jaki procent powierzchni działki leży w zasięgu zbiorników łącznie, od 0 do 100 |
| groundwater_bodies | array | null | poszczególne zbiorniki obejmujące działkę, od udokumentowanych i od największego udziału. Lista jest przycięta do pięciu pozycji |
| groundwater_bodies[].number / .name | number | string | null | urzędowy numer zbiornika i jego nazwa, np. nazwa niecki albo doliny kopalnej |
| groundwater_bodies[].documentation_status / .documented_year | string | number | null | stan udokumentowania tego zbiornika oraz rok jego udokumentowania, a przy późniejszej reambulacji rok reambulacji. Przy zbiornikach nieudokumentowanych rok zostaje pusty |
| groundwater_bodies[].depth_from_m | number | null | głębokość, od której zaczyna się zbiornik, w metrach. 0 znaczy zbiornik przypowierzchniowy |
| groundwater_bodies[].medium_type | string | null | typ ośrodka wodonośnego: porous, fissured, porous_fissured, karst, karst_fissured, karst_porous_fissured, a przy wartości spoza tej listy other. Ośrodek krasowy i szczelinowy przewodzi zanieczyszczenia szybciej niż porowy, więc to pole waży przy ocenie wrażliwości terenu |
| groundwater_bodies[].overlap_pct | number | null | jaki procent powierzchni działki leży w tym jednym zbiorniku |
| 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.
To są dwa niezależne wymiary i każdy bywa pusty osobno
Odpowiedź łączy dwa rejestry, które nie mają ze sobą nic wspólnego poza tym, że oba opisują to, co jest pod działką. Puste pola mining_* przy wypełnionych groundwater_* znaczą, że sprawdziliśmy oba i trafił tylko jeden - to nie jest brak danych. O całej odpowiedzi mówi dopiero coverage. Tylko covered_no_data znaczy, że działkę sprawdziliśmy i nie trafił żaden wymiar; not_covered mówi o naszym zbiorze, a not_computed, że warto ponowić za chwilę.
Rodzaj kopaliny waży więcej niż sam wpis
Większość terenów górniczych w rejestrze to żwirownie i piaskownie, a nie kopalnie. Dlatego samo „działka w terenie górniczym” jest alarmem bez treści i dlatego zwracamy mineral_class. Klasa subsidence obejmuje węgiel, rudy i sól kamienną, czyli eksploatację podziemną, z którą wiąże się ryzyko osiadania terenu. surface to kruszywa i kamień z odkrywek, gdzie wpływ jest miejscowy. fluid to wydobycie otworowe: gaz, ropa, solanki, wody lecznicze i termalne. Skalar podaje klasę najcięższą, a lista mining_terrains mówi, skąd się wzięła.
Teren górniczy to strefa wpływów, nie granica wydobycia
Obszar górniczy wyznacza granice, w których przedsiębiorca ma prawo wydobywać kopalinę. Teren górniczy obejmuje dodatkowo grunty, na które roboty górnicze mogą oddziaływać, i bywa od obszaru wyraźnie większy. Zwracamy tereny, bo to one odpowiadają na pytanie kupującego i rzeczoznawcy. Granice terenów w rejestrze są odwzorowane w przybliżeniu, więc przy działce leżącej przy samej krawędzi potwierdzenie bierze się w okręgowym urzędzie górniczym, którego nazwę podajemy w oversight_authority.
Zasięg zbiornika sam z siebie niczego nie zakazuje
Ograniczenia wynikałyby z obszaru ochronnego ustanowionego dla zbiornika, a takich obszarów ta warstwa nie zawiera. Zasięg GZWP mówi więc, gdzie leży zasób wód podziemnych o znaczeniu krajowym, a nie jaki reżim prawny obowiązuje na działce. Sygnał jest wart uwagi przy inwestycji potencjalnie uciążliwej dla wód: stacji paliw, składowisku, dużej fermie albo zakładzie z instalacją odprowadzającą ścieki. Przy zwykłej zabudowie mieszkaniowej sam wpis zwykle nie zmienia nic.
Flaga zbiornika rozróżnia lokalnie, nie krajowo
Rozkład zasięgu GZWP jest skrajny: w części powiatów zbiornik obejmuje niemal każdą działkę, w innych nie ma go wcale. Do nielicznych zbiorników nieudokumentowanych należy Subniecka warszawska, rozciągająca się pod znaczną częścią Mazowsza - tam odpowiedź undocumented jest stanem zwykłym, a nie wyjątkiem. Jeśli budujesz na tym filtr albo scoring, odnoś go do powiatu, bo krajowo ta flaga oddziela niewiele. Sygnał górniczy zachowuje się odwrotnie: jest rzadki, a w powiatach z eksploatacją węgla i rud potrafi obejmować większość działek.
Status z rejestru bywa spóźniony, daty są bliżej prawdy
Teren zniesiony nie znaczy, że po eksploatacji nie ma śladu: grunt pogórniczy zostaje po zakończeniu wydobycia i dla wyceny bywa równie istotny co teren czynny. W drugą stronę część terenów o statusie active ma valid_until już w przeszłości, bo wpis w rejestrze potrafi spóźniać się za wygaśnięciem koncesji. Zanim wyciągniesz wniosek z samego mining_status, sprawdź valid_until i revoked_on w liście terenów.
Cennik
Jedno wywołanie tego endpointu kosztuje 4 tokeny. Tokeny wracają, gdy działki nie mamy w zbiorze, gdy nie znamy jej obrysu, gdy nie mamy jeszcze wczytanych danych źródłowych, gdy odpowiedzi nie da się teraz policzyć oraz przy odpowiedziach 400 i 404. Potwierdzony brak trafienia w obu wymiarach 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. PIG-PIB udostępnia obie warstwy publicznie, razem z przeglądarką na mapie. My oddajemy je 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.
Obszar górniczy wyznacza granice, w których przedsiębiorca ma prawo wydobywać kopalinę. Teren górniczy obejmuje dodatkowo grunty, na które roboty górnicze mogą oddziaływać, więc jest szerszy i to on odpowiada na pytanie o wpływ na nieruchomość. Zwracamy tereny górnicze; obszarów górniczych w tej odpowiedzi nie ma.
Sam zasięg nie. Ograniczenia wynikają z obszaru ochronnego ustanowionego dla zbiornika, a takich obszarów ta warstwa nie zawiera i nie zapowiadamy ich. Odpowiedź mówi więc, że działka leży nad zasobem wód podziemnych o znaczeniu krajowym, i to jest sygnał do sprawdzenia przy inwestycji potencjalnie uciążliwej dla wód, a nie zakaz.
Nie. Odpowiedź niesie nazwę terenu górniczego, jego status, klasę kopaliny, organ nadzoru i daty, a po stronie zbiornika numer, nazwę, stan udokumentowania, głębokość i typ ośrodka. Danych przedsiębiorcy nie wczytujemy w ogóle, a identyfikatorów wewnętrznych rejestrów nie wystawiamy - na żadnym planie taryfowym.
Nie. Rejestr terenów górniczych obejmuje tereny wyznaczone dla koncesji, więc dawne albo płytkie wyrobiska sprzed jego powstania mogą się w nim nie pojawić. Brak zbiornika też nie znaczy, że pod działką nie ma wody: GZWP to zasoby o znaczeniu krajowym, a nie mapa wszystkich wód podziemnych.
4 tokeny. Tokeny wracają, gdy działki nie ma w naszym zbiorze albo nie znamy jej obrysu, gdy nie mamy jeszcze wczytanych danych źródłowych (wszystkie trzy przypadki wracają jako not_covered), gdy odpowiedzi nie dało się policzyć (not_computed), oraz przy odpowiedziach 400 i 404. Potwierdzony brak trafienia w obu wymiarach na znanej działce (covered_no_data) jest płatny, bo sprawdzenie wykonaliśmy.
W Claude na numer działki odpowiada narzędzie get_parcel_report. Zwraca jeden raport o działce, w którym sekcja o terenach górniczych i zbiornikach wód podziemnych 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=subsurface. Jak podłączyć serwer MCP.
Obie warstwy pochodzą z zasobów Państwowego Instytutu Geologicznego - Państwowego Instytutu Badawczego: tereny górnicze z bazy MIDAS, zbiorniki z bazy GZWP. Instytut udostępnia je na licencji Creative Commons Uznanie autorstwa 4.0 Międzynarodowe (CC BY 4.0), więc wolno ich używać komercyjnie i przekazywać dalej, wskazując źródło. Dane przetworzyliśmy: powiązaliśmy obiekty z działkami ewidencyjnymi, policzyliśmy udział powierzchni działki i ograniczyliśmy opis każdego obiektu do kilku pól. Identyfikatorów wewnętrznych rejestrów nie wystawiamy. Odpowiedź ma charakter poglądowy, a wiążące rozstrzygnięcia o terenie górniczym wydaje właściwy okręgowy urząd górniczy. 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.