Autouzupełnianie adresów w formularzu

Wypróbuj na prawdziwych danych

Pole powyżej działa bez rejestracji na tych samych danych, które dostaje Twój formularz. Zacznij od miejscowości, ulicy albo kodu pocztowego.

Jak to działa

Podpowiedzi idą ścieżką, która odpowiada temu, jak ludzie podają adres:

1. Miejscowość — GET /api/v1/miejscowosci?q=. Przy miejscowościach o tej samej nazwie lista pokazuje gminę i powiat.
2. Ulica — GET /api/v1/ulice, zawężona do wybranej miejscowości.
3. Numer — GET /api/v1/numery: tylko numery, które istnieją w PRG przy tej ulicy.
4. Kod pocztowy — GET /api/v1/lookup/autofill: kod, gmina i współrzędne wybranego punktu.

Po wyborze numeru dostajesz też stały identyfikator punktu adresowego (AID), który nie zmienia się przy zmianie nazwy ulicy czy kodu.

Trzy sposoby wdrożenia

1. Widget JavaScript (dowolna strona)

<input id="addr" data-adresy data-adresy-city="#city" data-adresy-postal="#zip">
<input id="city"> <input id="zip">

<script>window.AdresyWidget = { apiKey: "TWÓJ_KLUCZ_API" };</script>
<script src="https://api.adresy.app/static/adresy-widget.js" defer></script>

Widget czeka na 3 znaki i 200 ms przerwy w pisaniu (obie wartości zmienisz w konfiguracji), obsługuje klawiaturę (strzałki, Enter, Esc) i sam się wyłącza, gdy limit zapytań jest wyczerpany — formularz dalej działa jako zwykły.

Klucz w kodzie strony jest widoczny dla każdego odwiedzającego. W panelu klienta ogranicz go domeną i limitem zapytań.

2. Wtyczki do sklepów

Gotowe integracje: WooCommerce, PrestaShop i Magento 2. Porównanie rozwiązań znajdziesz w artykule Wtyczki weryfikacji adresów w e-commerce.

3. Własna implementacja przez API

Zapytania z nagłówkiem X-API-Key albo Authorization: Bearer. Pełny opis endpointów: dokumentacja API. Krok po kroku: Autocomplete adresu krok po kroku.

Co zyskuje sklep

• Krótszy formularz. Kod pocztowy i gmina wpisują się same, więc znikają pola, w których klienci się mylą.
• Mniej błędnych adresów. Klient wybiera z listy istniejące punkty, zamiast zgadywać pisownię ulicy.
• Mniej poprawek ręcznych. Zespół obsługi nie dzwoni z pytaniem, o który budynek chodziło. Więcej o kosztach: Ukryte koszty błędnych adresów.

Czego nie robi

• Działa dla adresów w Polsce. Dla innych krajów potrzebujesz innego dostawcy.
• Nie podstawia sąsiedniego numeru. Jeśli klient wpisze numer, którego nie ma w PRG, dowie się o tym, zamiast dostać cudzy budynek. Zasada opisana w weryfikacji adresu.
• Nowo wybudowany budynek może pojawić się w PRG z opóźnieniem. Zostaw w formularzu możliwość wpisania numeru ręcznie.

Cennik

Autouzupełnianie jest dostępne od planu Free. Podpowiedzi zużywają pulę zapytań planu.

Ile to kosztuje w porównaniu z Google Places: porównanie kosztów.