Wysyłanie prośby o weryfikację adresu

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Jeśli Twój adres rozliczeniowy znajduje się w Europejskim Obszarze Gospodarczym, od 8 lipca 2025 r. do korzystania z usług będą miały zastosowanie Warunki korzystania z usługi Google Maps Platform w EOG. Funkcje różnią się w zależności od regionu. Więcej informacji

Wyślij żądanie weryfikacji adresu, wysyłając żądanie POST do jednego z tych punktów końcowych:

• validateAddress (REST)
• ValidateAddress (gRPC)

Uwaga: w przykładach w tej dokumentacji używamy REST, ale podejście jest podobne w przypadku gRPC.

Żądanie powinno też przekazywać treść żądania JSON do żądania, które definiuje adres do zweryfikowania. Treść żądania poniżej zawiera 1 pole i 3 podpola:

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"

Możesz też pominąć locality i określić go jako element w tablicy addressLines:

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

Narzędzie APIs Explorer umożliwia wysyłanie żądań w czasie rzeczywistym, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami:

Wypróbuj

Pola żądania adresu

Treść żądania składa się z jednego pola:

• address – pole typu PostalAddress, które musi zawierać co najmniej 1 wpis w addressLines.

Wysyłając pole address do interfejsu Address Validation API, musisz podać tylko jedno pole: addressLines. Jednak najprostsze żądanie adresu powinno zawierać te pola podrzędne:

• regionCode – zalecane. To pole jest opcjonalne, ale jeśli zostanie pominięte, interfejs Address Validation API określi region na podstawie adresu. Aby jednak uzyskać najlepsze wyniki, podaj regionCode, jeśli go znasz. Listę obsługiwanych regionów znajdziesz w tym artykule.
• addressLines – wymagany. Tablica z adresami opisującymi niższą strukturę adresu.

Więcej informacji znajdziesz w sekcji PostalAddress w przewodniku.

Opcja USPS CASS™

Amerykańska poczta (United States Postal Service®, USPS®)¹ utrzymuje system Coding Accuracy Support System (CASS™), który wspiera i certyfikuje dostawców usług weryfikacji adresów.

Uwaga: Address Validation API jest usługą z certyfikatem CASS-Certified™. Oznacza to, że usługa została zweryfikowana pod kątem możliwości uzupełniania brakujących informacji adresowych, standaryzacji i aktualizacji do najbardziej aktualnego i dokładnego adresu.

Tylko w przypadku regionów US i PR możesz włączyć przetwarzanie CASS, ustawiając enableUspsCass na true w treści żądania. Aby uzyskać najlepsze wyniki podczas korzystania z CASS, podaj adres, który zawiera ulicę i numer domu, a także miasto, stan i kod pocztowy:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

Uwaga: jeśli nie potrzebujesz przetwarzania CASS lub weryfikujesz adresy poza Stanami Zjednoczonymi i Portoryko, Google nie zaleca włączania tej funkcji.

Wypróbuj

Narzędzie APIs Explorer umożliwia wysyłanie przykładowych żądań, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami.

1. Po prawej stronie kliknij ikonę interfejsu API api.

2. Opcjonalnie możesz edytować parametry żądania.

3. Kliknij przycisk Wykonaj. W oknie wybierz konto, którego chcesz użyć do wysłania prośby.

4. W panelu APIs Explorer kliknij ikonę pełnego ekranu fullscreen, aby rozwinąć okno APIs Explorer.

---

1. Google Maps Platform jest niewyłącznym licencjobiorcą United States Postal Service®. Następujące znaki towarowe są własnością United States Postal Service® i są używane za zgodą: United States Postal Service®, CASS™, CASS Certified™. ↩