Adres ze współrzędnych według działki od 13.10.2026

Od 13.10.2026 geokodowanie odwrotne w adresy.app nie bierze już po prostu najbliższego punktu adresowego. Najpierw ustala działkę, na której leży punkt, i szuka adresu w jej granicach. Dzięki temu odpowiedzią nie jest adres sąsiada, a dla działki bez numeru porządkowego dostajesz jej numer ewidencyjny zamiast cudzego adresu.

Co się zmieniło

Dotąd współrzędne dostawały adres najbliższego punktu PRG. Od 13 października 2026 kolejność jest inna:

ustalamy działkę ewidencyjną, na której leży punkt,
szukamy punktów adresowych wewnątrz jej granic,
dopiero w tym zbiorze rozstrzyga odległość.

Dotyczy to wszystkich wejść, w których adres wyznaczamy ze współrzędnych: endpointu GET /api/v1/reverse, zapytań /api/v1/match ze współrzędnymi, mapy w aplikacji i wsadów z kolumną współrzędnych. Konta z aktywnym kluczem API dostały zapowiedź mailem 29 września 2026.

Dlaczego odległość nie wystarcza

Sprawdziliśmy to na produkcji: dla 3 000 losowych działek, które mają punkt adresowy, w 5,2% przypadków najbliższy punkt PRG do wnętrza działki należy do innej działki. Budynki stoją kilkanaście metrów od siebie, a odległość nie wie, gdzie biegnie granica własności. Taka odpowiedź wygląda pewnie, jest kompletnym adresem i bywa adresem sąsiada. Granica działki rozstrzyga jednoznacznie, który adres opisuje daną nieruchomość.

Jak teraz wyznaczamy adres

Sytuacja	Odpowiedź	Flaga
w działce jest jeden punkt adresowy	ten adres	`ADRES_Z_DZIALKI`
w działce jest kilka punktów (bliźniak, blok)	najbliższy z tej działki i liczba punktów	`ADRES_Z_DZIALKI` + `WIELE_PUNKTOW_NA_DZIALCE`
w działce nie ma punktu, ale tuż obok (do 15 m) leży punkt, który nie należy do żadnej działki	ten adres, z niższą pewnością	`ADRES_PRZY_DZIALCE`
działka znana i bez numeru porządkowego	numer działki (np. „dz. 34/3”), bez adresu sąsiada	`DZIALKA_BEZ_ADRESU`
punkt na działce drogowej (jezdnia, pas drogowy)	najbliższy punkt do 50 m, jak dotychczas	`DZIALKA_DROGOWA`
działki nie udało się ustalić	zachowanie dotychczasowe, po odległości	`DZIALKA_NIEUSTALONA`

Ostatni wiersz jest ważny: brak ustalonej działki nigdy nie zamienia trafienia w not_found. Rozróżniamy dwie sytuacje, które wcześniej wyglądały tak samo: „ta działka nie ma adresu" i „nie wiemy, czyja to działka".

Przykład odpowiedzi `/reverse`

Lista results zostaje bez zmian, żeby kod klientów nadal działał. Wiersze z działki trafiają na jej początek i mają w_dzialce: true. Doszły pola opisujące działkę:

{
  "query":   { "lat": …, "lon": …, "radius_m": 500 },
  "count":   3,
  "results": [ { "w_dzialce": true, "distance_m": …, "ulica": …, "nr_budynku": …, … }, … ],
  "dzialka":          { "id": …, "numer": …, "obreb": …, "gmina": …, "pow_m2": … },
  "etykieta_dzialki": "dz. 34/3",
  "adres_dzialki":    { … },
  "flagi":            ["ADRES_Z_DZIALKI"]
}

Gdy punkt leży na działce bez adresu, adres_dzialki jest puste, a etykieta_dzialki niesie numer. Gdy działka jest drogowa, adres_dzialki też jest puste, a lista results zostaje posortowana po odległości.

Co zmienia się w `/match`

Wynik wyznaczony z działki ma match_layer: "DZIALKA" i obiekt dzialka z identyfikatorem, numerem, obrębem, gminą i powierzchnią. Statusy:

matched — jeden punkt w działce, wynik pewny;
low_confidence — kilka punktów w działce albo punkt „przy działce";
not_found — działka znana, ale bez numeru porządkowego. Pole match jest wtedy puste, a suggestion mówi, na której działce leży punkt.

To jest zmiana kontraktu: punkt, który dotąd dostawał pewnie wyglądający adres sąsiada, dostanie not_found z numerem działki. Jeśli Twoja aplikacja zakłada, że współrzędne zawsze dają adres, dodaj obsługę not_found i flagi DZIALKA_BEZ_ADRESU.

GPS z ulicy: działki drogowe

Współrzędne z telefonu kuriera albo kliknięcie w jezdnię lądują zwykle w działce pasa drogowego, która adresu nie ma i mieć nie będzie. Zmierzyliśmy, że punkty PRG przesunięte o około 10 m trafiały w taką działkę i dawały DZIALKA_BEZ_ADRESU w 21% przypadków. To nie jest odpowiedź, jakiej oczekuje ktoś, kto stoi przed domem.

Dlatego rozpoznajemy drogę po kształcie: długi, wąski pas (wydłużenie P²/4πA co najmniej 6 i średnia szerokość 2A/P do 50 m), albo po osi drogi krajowej lub wojewódzkiej z BDOT10k przechodzącej przez działkę. W pomiarze wykrywa to 86% działek pod osią dróg i tylko 3,2% zwykłych działek. Pomyłka kosztuje niewiele: zwykła działka dostaje dotychczasowe zachowanie (najbliższy punkt) z flagą DZIALKA_DROGOWA. Po zmianie not_found przy współrzędnych przesuniętych o 10 m spadło z 21% do 4–8%. Promień szukania wynosi 50 m, żeby pas pola za wsią nie dostał adresu z odległości 300 m.

Działki po przenumerowaniu

Po zmianie numeracji działek (§ 44 EGiB) stara i nowa działka mają tę samą geometrię. Bierzemy tylko działki obowiązujące, dzięki czemu adres nie zależy od tego, który z dwóch bliźniaczych obrysów wygra w sortowaniu. Wrocław, gdzie przenumerowanie zakończyło się 24 września, miał przed poprawką 6% punktów przypisanych do starego numeru. Szerzej o zmianie numeracji: Zmiana numeracji działek ewidencyjnych.

Dane i wydajność

35,4 mln obrysów działek w naszym zbiorze ewidencji gruntów, cały kraj od 20.09.2026, i 8,6 mln punktów adresowych PRG.
0,88% punktów PRG leży poza obrysem jakiejkolwiek działki (próba 2 157 punktów z 60 losowych kafli). To głównie pas drogowy i luki w pokryciu ewidencji; w samych miastach 0,00%. Dla nich służy krok „przy działce".
Rozstrzygnięcie liczymy na żywo, a nie z tabeli pośredniej, bo tablica mapowań pokrywa dziś około 68% punktów. Oparcie reguły na niej dawałoby „działkę bez adresu" przy prawdziwych adresach.
Czas: mediana około 1 ms, najgorszy zmierzony przypadek 11 ms (dla działek z adresem). Dla pustej działki (najwolniejszy przypadek) po optymalizacji mediana to 10 ms, a 95. percentyl 216 ms, wobec 9–15 s przed poprawką.

Ograniczenia

Granica własności to nie ogrodzenie. Działka bywa podzielona ogrodzeniem albo obejmuje kilka budynków pod różnymi numerami. Dlatego przy kilku punktach dostajesz flagę WIELE_PUNKTOW_NA_DZIALCE i listę, a nie jeden „pewny" wynik.
Nowe działki spoza naszego zbioru dociągamy z usług GUGiK tylko w zapytaniach wywołanych przez człowieka (mapa, pojedyncze zapytanie). We wsadach plików z tysiącami wierszy nie sięgamy do sieci; tam brak działki daje DZIALKA_NIEUSTALONA i wynik jak dawniej.
Dane ewidencji bywają starsze niż rzeczywistość. Nowo wybudowany budynek może jeszcze nie mieć punktu w PRG; wtedy zobaczysz numer działki, nie adres.
Wynik opisuje działkę, na której leży punkt, a nie człowieka, który ją zajmuje. Właściciela nie podajemy.

Kto na tym zyskuje

Kurierzy i logistyka — współrzędne z aplikacji kierowcy trafiają pod właściwy adres, nie do sąsiada: dane adresowe dla logistyki.
Sklepy — przycisk „użyj mojej lokalizacji" w formularzu dostawy: autouzupełnianie w e-commerce i podpowiedzi adresu.
Geokodowanie portfeli — banki i ubezpieczyciele z listą współrzędnych zabezpieczeń dostają adres zgodny z granicą nieruchomości: bankowość i ubezpieczenia.
Nieruchomości — adres i działka dla punktu na mapie, łatwe połączenie z cenami z RCN: rynek nieruchomości.
Samorządy i energetyka — przypisanie zgłoszenia terenowego do działki i adresu.

Jak to sprawdzić

W aplikacji: kliknij punkt na mapie (mapa adresów PRG) albo użyj narzędzia adres po współrzędnych.
W API: GET /api/v1/reverse?lat=…&lon=…, opis w dokumentacji. Podstawy geokodowania odwrotnego: Geokodowanie odwrotne — znajdź adres po współrzędnych GPS.
Jednoznaczny identyfikator punktu, który dostajesz w wyniku: Jak jednoznacznie zidentyfikować punkt adresowy.

Zapytania zużywają pulę planu zgodnie z cennikiem: Free — bezpłatny, 30 zapytań/min, 3 000 zapytań miesięcznie; Mini — 19 zł netto miesięcznie, 60 zapytań/min, 30 000 zapytań miesięcznie; Starter — 39 zł netto miesięcznie, 200 zapytań/min, 100 000 zapytań miesięcznie; Business — 299 zł netto miesięcznie, 1 200 zapytań/min, 10 000 000 zapytań miesięcznie.

Dane źródłowe

Adresy pochodzą z Państwowego Rejestru Granic (GUGiK), obrysy działek z ewidencji gruntów i budynków udostępnianej przez GUGiK. Podajemy źródło zgodnie z przepisami o danych udostępnianych bez opłat.

FAQ

Od kiedy adres ze współrzędnych wyznaczany jest według działki?

Od 13 października 2026. Konta z aktywnym kluczem API dostały zapowiedź mailem 29 września 2026.

Co oznacza flaga DZIALKA_BEZ_ADRESU?

Działka jest znana, ale nie nadano jej numeru porządkowego, więc nie ma na niej adresu. Odpowiedź zawiera numer działki (np. „dz. 34/3”), a nie adres sąsiada.

Dlaczego dostaję not_found tam, gdzie wcześniej był adres?

Wcześniej punkt na działce bez adresu dostawał adres najbliższego sąsiada. Teraz dostaje not_found z numerem działki. Jeśli współrzędne leżą na jezdni, zadziała reguła działki drogowej i dostaniesz najbliższy adres z flagą.

Czy lista results w /reverse nadal jest posortowana po odległości?

Wiersze z działki, w której leży punkt, idą na początek i mają w_dzialce: true; pozostałe wiersze są dalej, według odległości. Gdy działka jest drogowa albo jej nie ustalono, lista jest posortowana po odległości jak dawniej.

Co robi flaga WIELE_PUNKTOW_NA_DZIALCE?

Mówi, że w działce jest więcej niż jeden punkt adresowy (bliźniak, kilka budynków, blok). Wybieramy najbliższy z nich, ale pewności jest mniej niż przy jednym punkcie, więc pokazujemy też pozostałe.

Czy wsad pliku ze współrzędnymi też korzysta z granic działki?

Tak, ale tylko z działek, które mamy w zbiorze. Wsad nie sięga po działki do usług GUGiK, żeby plik z tysiącami wierszy nie przeciążył ich serwerów. Gdy działki nie ma w zbiorze, wiersz dostaje flagę DZIALKA_NIEUSTALONA i wynik jak dawniej.

Czy podajecie właściciela działki?

Nie. Zwracamy identyfikator, numer, obręb, gminę, powierzchnię i adres punktu, bez danych o właścicielu.

Czy działa to dla całej Polski?

Mamy obrysy działek dla całego kraju (35,4 mln od września 2026). Jakość zależy od aktualności ewidencji w danym powiecie; nowe działki mogą pojawiać się z opóźnieniem.