Wysyłanie prośby o weryfikację adresu

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Jeśli adres rozliczeniowy znajduje się w Europejskim Obszarze Gospodarczym, od 8 lipca 2025 r. 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

Aby wysłać prośbę o weryfikację adresu, wyślij żądanie POST do jednego z tych punktów końcowych:

• validateAddress (REST)
• ValidateAddress (gRPC)

Uwaga: w tym dokumencie przykłady są oparte na interfejsie REST, ale podejście jest podobne w przypadku interfejsu gRPC.

Żądanie powinno też zawierać treść żądania w formacie JSON, która określa adres do weryfikacji. Treść żądania 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ąć element locality i podać go jako element tablicy addressLines:

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

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

Wypróbuj

Pola prośby o adres

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

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

Wysyłając pole address do interfejsu Address Validation API, musisz podać tylko 1 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 API weryfikacji adresów wywnioskuje region na podstawie adresu. Jednak aby uzyskać najlepsze wyniki, dodaj regionCode, jeśli znasz tę wartość. Listę obsługiwanych regionów znajdziesz w sekcji obsługiwane regiony.
• addressLines – wymagane. Tablica z adresami, które opisują strukturę adresu.

Więcej informacji znajdziesz w sekcji PostalAddress w przewodniku.

Opcja USPS CASS™

United States Postal Service® (USPS®)¹ utrzymuje System obsługi dokładności kodowania (CASS™), aby wspierać i certyfikować dostawców usług weryfikacji adresów.

Uwaga: interfejs API weryfikacji adresu został zatwierdzony jako usługa CASS-Certified™. Oznacza to, że usługa została zweryfikowana pod kątem możliwości uzupełniania brakujących informacji adresowych, standaryzowania ich i aktualizowania do najnowszego i najdokładniejszego adresu.

Tylko w Stanach Zjednoczonych i Portoryko możesz włączyć przetwarzanie CASS, ustawiając wartość enableUspsCass na true w ciele żądania. Aby uzyskać najlepsze wyniki podczas korzystania z CASS, podaj adres zawierający ulicę i numer domu, 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 regionami USA 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 strony kliknij ikonę interfejsu API api.

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

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

4. W panelu narzędzia APIs Explorer kliknij ikonę pełnego ekranu Pełny ekran, aby rozwinąć okno narzędzia APIs Explorer.

---

1. Google Maps Platform jest licencjobiorcą niewyłącznym 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™. ↩