Wysyłanie prośby o weryfikację adresu

Wyślij prośbę o weryfikację adresu, wysyłając żądanie POST do jednego z następujące punkty końcowe:

• validateAddress (REST),
• ValidateAddress (gRPC)

.

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

Żądanie powinno również przekazywać treść żądania JSON do żądania, które wskazuje adres do weryfikacji. Poniższa treść żądania zawiera 1 pole oraz 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ąć locality i określić go jako element w tablica addressLines:

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

Wypróbuj

Pola żądania adresu

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

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

Wysyłając pole address do interfejsu Address Validation API, potrzebujesz tylko podaj jedno pole: addressLines. Jednak najprostsze żądanie adresu powinien zawierać następujące pola podrzędne:

• regionCode – zalecane. To pole jest opcjonalne, ale w przypadku jego pominięcia Interfejs API do weryfikacji adresu określa region na podstawie adresu. Jednak uwzględnij regionCode, jeśli go znasz. Listę obsługiwanych regionów znajdziesz w tym artykule.
• addressLines – wymagane. Tablica z adresami opisującymi dolną wartość w strukturze adresu.

Zobacz PostalAddress w przewodniku.

Opcja USPS CASSTM

Urząd pocztowy USPS® (USPS®)¹ obsługuje Systemu wsparcia dokładności kodowania (CASSTM) do obsługi i certyfikowania dostawców weryfikacji adresów.

Uwaga: interfejs Address Validation API ma certyfikat CASS-CertifiedTM. Ten oznacza, że usługa została potwierdzona pod kątem możliwości uzupełnienia brakującego adresu ich ustandaryzowanie, aktualizowanie i aktualizowanie

Tylko w przypadku Stanów Zjednoczonych i regionów PR możesz włączyć przetwarzanie CASS, ustawiając enableUspsCass do true w treści żądania. Aby uzyskać najlepsze rezultaty podczas używania funkcji CASS podaj adres zawierający ulicę i numer domu, a także miasto, województwo i kod pocztowy:

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

Uwaga: jeśli nie wymagasz przetwarzania CASS lub przeprowadzasz weryfikację adresów spoza Stanów Zjednoczonych i regionów PR, Google nie zaleca tę funkcję.

Wypróbuj

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

1. Kliknij ikonę interfejsu API . w prawej części strony.

2. Opcjonalnie rozwiń opcję Pokaż parametry standardowe i ustaw fields do pola .

3. Opcjonalnie edytuj Treść żądania.

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

5. W panelu Eksplorator API kliknij ikonę rozwijania. , aby rozwinąć okno Eksploratora interfejsów API.

---

1. Google Maps Platform jest niewyłącznym licencjobiorcą Stanów Zjednoczonych Postal Service®. Następujące znaki towarowe należą do Stanów Zjednoczonych Postal Service® i używane za zgodą: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩