Wysyłanie prośby o weryfikację adresu

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

• validateAddress (REST)
• ValidateAddress (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"]
  },
}

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 je znasz. 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.

Tylko w regionach USA i Portoryko możesz włączyć przetwarzanie CASS, ustawiając wartość enableUspsCass na true w treści żą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
}

Wypróbuj

Narzędzie API 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ę API .

2. Opcjonalnie rozwiń Pokaż parametry standardowe i ustaw parametr fields na maskę pola.

3. Opcjonalnie możesz zmodyfikować tekst prośby.

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

5. W panelu API Explorer kliknij ikonę rozwijania , aby rozwinąć okno API Explorer.