Invia una richiesta di convalida dell'indirizzo inviando una richiesta POST a uno dei seguenti endpoint:
- validateAddress (REST)
- ValidateAddress (gRPC)
La richiesta deve anche passare un corpo della richiesta JSON alla richiesta che definisce l'indirizzo da convalidare. Il seguente corpo della richiesta contiene un campo e tre sottocampi:
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"
Puoi anche omettere locality
e specificarlo come elemento
nell'array addressLines
:
{
"address": {
"regionCode": "US",
"addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
},
}
Campi di richiesta dell'indirizzo
Il corpo della richiesta è composto da un singolo campo:
address
: un campo di tipoPostalAddress
, che deve contenere almeno una voce inaddressLines
.
Quando invii il campo address
all'API Address Validation, devi fornire un solo campo: addressLines
. Tuttavia, la richiesta di indirizzo più semplice
dovrebbe contenere i seguenti campi secondari:
regionCode
: opzione consigliata. Questo campo è facoltativo; tuttavia, se omesso, l'API Address Validation deduce la regione dall'indirizzo. Tuttavia, per ottenere i risultati migliori, includi ilregionCode
, se lo conosci. Per l'elenco delle regioni supportate, vedi Regioni supportate.addressLines
: obbligatorio. Un array di indirizzi che descrive la struttura inferiore dell'indirizzo.
Consulta PostalAddress nella guida di riferimento. |
Opzione USPS CASSTM
United States Postal Service® (USPS®)1 gestisce il Coding Accuracy Support System (CASSTM) per supportare e certificare i fornitori di convalida degli indirizzi.
Solo per le regioni di Stati Uniti e PR, puoi abilitare l'elaborazione CASS impostando
enableUspsCass
su true
nel corpo della richiesta. Per ottenere risultati ottimali quando si utilizza CASS, fornire un indirizzo che includa la via e il numero civico insieme a città, stato e CAP:
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
Prova.
Explorer API consente di effettuare richieste di esempio, per acquisire familiarità con le opzioni API e API.
Seleziona l'icona dell'API sul lato destro della pagina.
Se vuoi, espandi Mostra parametri standard e imposta il parametro
fields
sulla maschera di campo.Se vuoi, modifica il corpo della richiesta.
Seleziona il pulsante Esegui. Nella finestra di dialogo, scegli l'account da usare per effettuare la richiesta.
Nel riquadro Explorer API, seleziona l'icona Espandi, , per espandere la finestra di Explorer API.
-
Google Maps Platform è un licenziatario non esclusivo di United States Postal Service®. I seguenti marchi sono di proprietà di United States Postal Service® e vengono utilizzati con autorizzazione: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩