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)
Żą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"]
},
}
Pola żądania adresu
Treść żądania składa się z jednego pola:
address
– pole typuPostalAddress
, które musi zawierać co najmniej jeden wpis w zakresieaddressLines
.
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ędnijregionCode
, 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®)1 obsługuje Systemu wsparcia dokładności kodowania (CASSTM) do obsługi i certyfikowania dostawców weryfikacji adresów.
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
}
Wypróbuj
API Explorer umożliwia wysyłanie przykładowych żądań, aby zapoznać się z interfejsem API i jego opcjami.
Kliknij ikonę interfejsu API
. w prawej części strony.
Opcjonalnie rozwiń opcję Pokaż parametry standardowe i ustaw
fields
do pola .Opcjonalnie edytuj Treść żądania.
Kliknij przycisk Wykonaj. W oknie wybierz konto, którego którego chcesz użyć do przesłania żądania.
W panelu Eksplorator API kliknij ikonę rozwijania.
, aby rozwinąć okno Eksploratora interfejsów API.
-
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. ↩