Jak zweryfikować tysiące adresów z pliku CSV — batch matching

Import listy adresów, dopasowanie do bazy PRG, eksport wyników z oceną jakości. Jak działa przetwarzanie pliku w panelu adresy.app i kiedy używać streamingu zamiast synchronicznego API.

Masz listę adresów w arkuszu, bazie danych lub eksporcie z CRM. Część z nich może być błędna — literówki, stare nazwy ulic, brakujące kody pocztowe. Batch matching w adresy.app pozwala zweryfikować całą listę jednym uploadem i pobrać wyniki z oceną jakości każdego adresu.

Jak działa przetwarzanie pliku

Panel Operacje na plikach przyjmuje pliki CSV, XLSX lub TXT. Po wgraniu plik jest automatycznie analizowany w czterech krokach:

Detekcja kolumn — system rozpoznaje kolumny adresowe (ulica, numer, miejscowość, kod pocztowy) lub kolumny koordynatów (LAT/LON z separatorem kropką lub przecinkiem)
Mapowanie — wskazujesz, która kolumna jest ulicą, która numerem budynku. Możesz też wybrać tryb koordynatów — wtedy system wykonuje geokodowanie odwrotne dla każdego wiersza
Przetwarzanie — każdy adres jest dopasowywany do bazy PRG algorytmem fuzzy-match (RapidFuzz + heurystyki polskich skrótów). Wynik zawiera score 0–1
Eksport — pobierasz plik z oryginalnymi kolumnami plus: dopasowany adres, kod pocztowy, współrzędne GPS, teryt_simc, score

Tryb koordynatów GPS

Jeśli Twój plik zawiera kolumny z szerokością i długością geograficzną, wybierz tryb Koordynaty GPS. System automatycznie wykryje kolumny LAT/LON (obsługuje separator dziesiętny: kropkę i przecinek, nagłówki w różnych językach). Każdy wiersz zostanie przetworzony przez geokodowanie odwrotne — wynik to pełny adres PRG z odległością od punktu GPS.

Interpretacja score

0,9–1,0 — dopasowanie pewne (adres istnieje w PRG, brak literówek)
0,7–0,9 — dopasowanie prawdopodobne (drobne różnice, np. skrócona nazwa ulicy)
0,5–0,7 — dopasowanie wątpliwe (sprawdź ręcznie)
poniżej 0,5 — brak dopasowania lub adres nieistniejący

Wydajność: około 200–500 wierszy na sekundę. Standardowy upload obsługuje do 100 000 wierszy jednorazowo. Przejdź do operacji na plikach →

FAQ

Jakie formaty pliku są obsługiwane?

CSV (separator przecinek lub średnik, kodowanie UTF-8 lub Windows-1250), XLSX (Excel), TXT (jeden adres w linii). Plik musi mieć nagłówki w pierwszym wierszu.

Czy mogę przetworzyć plik z koordynatami zamiast adresów?

Tak — wybierz tryb Koordynaty GPS w panelu. System automatycznie wykryje kolumny z szerokością i długością geograficzną, obsługuje separator dziesiętny zarówno kropkę jak i przecinek.

Jak długo czeka się na wyniki dla 50 000 wierszy?

Przy 300 wierszach/sekundę to około 2–3 minuty. Przetwarzanie odbywa się w tle — możesz zamknąć przeglądarkę i wrócić po chwili. Wyniki są dostępne przez 7 dni.

Czy wyniki można pobrać przez API bez panelu?

Tak — użyj POST /api/v1/match z tablicą adresów (batch do 1000 w jednym requeście) lub POST /api/v1/match/stream dla strumieniowania NDJSON.