Wysyłanie prośby o weryfikację adresu

Wyślij żądanie weryfikacji adresu, wysyłając żą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. Poniższa treść żądania zawiera 1 pole i 3 pola podrzędne:

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 najlepsze wyniki uzyskasz, dodając regionCode, jeśli znasz tę wartość. Listę obsługiwanych regionów znajdziesz w sekcji obsługiwane regiony.
• addressLines – wymagane. Tablica z adresami opisującymi dolną strukturę adresu.

Opcja USPS CASS™

United States Postal Service® (USPS®)¹ utrzymuje system kodowania dokładnościowego (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, województwo i kod pocztowy:

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

Wypróbuj

API Explorer umożliwia wykonywanie przykładowych żądań, aby zapoznać się z interfejsem API i jego opcjami.

1. Wybierz ikonę interfejsu API () po prawej stronie.

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

3. Opcjonalnie edytuj Treść żądania.

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

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