Dane adresowe gotowe dla Twojego systemu

API geokodowania adresów

Zamieniaj adresy na współrzędne i ujednolicone dane gotowe do użycia w logistyce, e-commerce, CRM oraz analizach przestrzennych.

Zapytania pojedyncze i paczkiGeokodowanie zwykłe i odwrotneJakość dopasowania w odpowiedzi
Domaniewska 37, Warszawa52.18284, 21.0071318

Od tekstu do decyzji

Adres sam w sobie nie mówi systemowi, gdzie coś się znajduje

Geokodowanie dodaje do danych adresowych warstwę przestrzenną. Dopiero wtedy można liczyć odległości, planować przejazdy, analizować zasięgi i pokazywać obiekty na mapie.

01

Dane gotowe do działania

Zamień adres na współrzędne dla mapy, CRM, planu dostaw albo analizy zasięgu.

02

Mniej ręcznych poprawek

Uporządkuj różne sposoby zapisu miejscowości, ulic i numerów budynków przed dalszym przetwarzaniem.

03

Lepsze decyzje przestrzenne

Przypisuj klientów do oddziałów i pracuj na konkretnym punkcie zamiast nieustrukturyzowanego tekstu.

Prosty przepływ

Od adresu do punktu w trzech krokach

Ten sam schemat działa w formularzu, imporcie danych i automatycznej integracji backendowej.

  1. 1

    Przekaż adres

    Obiekt address musi zawierać pole city. Pola country i street są opcjonalne; brak lub null w country ustawia domyślnie PL. Pola pcode i house pomagają zawęzić dopasowanie.

  2. 2

    Odbierz dopasowanie

    API zwraca współrzędne, ujednolicony adres i informacje pomagające ocenić jakość wyniku.

  3. 3

    Użyj punktu

    Zapisz go, pokaż na mapie albo przekaż do tras, macierzy i analiz przestrzennych.

Od zastosowania do kontraktu

Geokoduj adres i wykorzystaj zwrócony punkt

Wyślij adres strukturalny, oceń quality i resultRadius, a potem użyj współrzędnych na mapie, w trasie lub procesie dostawy.

  • Geocoder.geocode dla pojedynczych adresów
  • Geocoder.geocodemulti dla paczek
  • Geocoder.revgeocode dla współrzędnych
  • interpretacja quality i resultRadius
Otwórz referencję geokodowania
cURL
curl -X POST https://api.automapa.com/v3/Geocoder/geocode \
  -H "Content-Type: application/json" \
  -H "Session-Id: $AUTOMAPA_SESSION" \
  -d '{
    "address": {
      "country": "PL",
      "city": "Warszawa",
      "street": "Domaniewska",
      "house": "37",
      "maxResult": 1
    }
  }'
200 OK — pełna otoczka odpowiedzi{ "result": [ { "quality": 9, "x": 21.0071318, "y": 52.18284, "city": "Warszawa", "street": "Domaniewska", "house": "37", "resultRadius": 0 } ] }Wartości w przykładzie pokazują format odpowiedzi. Współrzędne i dane adresowe zależą od zapytania oraz aktualnych danych mapowych.

Metody i usługi powiązane

Geokodowanie często rozpoczyna większy proces

Otrzymany punkt może trafić do geokodowania odwrotnego, podpowiedzi, tras, macierzy i analiz drogowych.

Geokodowanie paczek

Geocoder.geocodemulti

Przetwarzaj wiele adresów w jednym zapytaniu.

Dokumentacja

Geokodowanie odwrotne

Geocoder.revgeocode

Zamieniaj współrzędne na najbliższy czytelny adres.

Dokumentacja

Podpowiedzi adresów

Autocomplete.searchAddress

Pomagaj użytkownikom wpisać spójny adres jeszcze przed geokodowaniem.

Dokumentacja

Trasy i macierze

Routes.route / Routes.matrix

Używaj zgeokodowanych punktów do liczenia czasu i odległości.

Dokumentacja

Zastosowania

Geokodowanie jest częścią procesu, nie jego ostatecznym celem

Logistyka

Przygotuj adresy odbioru i dostawy do wyznaczania tras i planowania dostaw.

E-commerce

Weryfikuj lokalizacje zamówień i ogranicz ręczne poprawki.

Sieci sprzedaży

Znajduj najbliższy oddział i przypisuj klientów do regionów.

Jakość danych

Ujednolicaj historyczne bazy adresowe przed migracją lub analizą.

Najczęstsze pytania

Podstawy geokodowania przed integracją

Czym jest geokodowanie?

Geokodowanie zamienia opis adresu na współrzędne geograficzne, które można pokazać na mapie lub wykorzystać w procesach lokalizacyjnych.

Które pola są wymagane?

Obiekt address i jego pole city są wymagane dla każdego adresu, również w żądaniu wsadowym. Pola country i street są opcjonalne; brak lub null w country ustawia domyślnie PL. Pola pcode i house mogą zwiększyć precyzję.

Jak ocenić wynik?

Odpowiedź zawiera jakość dopasowania i promień wyniku. Dokumentacja wyjaśnia ich interpretację dla różnych zastosowań.

Czy mogę przetwarzać wiele adresów?

Tak. Metoda Geocoder.geocodemulti jest przeznaczona do paczek adresów.

Czy podgląd wywołuje produkcyjne API?

Nie. Prezentuje przykładową odpowiedź, a dokumentacja pokazuje sposób wykonania uwierzytelnionego zapytania do API.