Invia una richiesta di convalida dell'indirizzo inviando una richiesta POST a uno dei seguenti endpoint:
- validateAddress (REST)
- ValidateAddress (gRPC)
La richiesta deve anche trasmettere alla richiesta un corpo della richiesta JSON che definisce l'indirizzo da convalidare. Il seguente corpo della richiesta contiene un campo e tre campi secondari:
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=YOUR_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 è costituito 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 deve contenere i seguenti campi secondari:
regionCode
- Consigliato. Si tratta di un campo facoltativo, ma se omesso, l'API Address Validation deduce la regione dall'indirizzo. Tuttavia, per ottenere risultati migliori, includiregionCode
, se lo conosci. Per l'elenco delle regioni supportate, vedi la sezione relativa alle regioni supportate.addressLines
: campo obbligatorio. Un array con indirizzi che descrivono la struttura inferiore dell'indirizzo.
Consulta PostalAddress nella guida di riferimento. |
Opzione USPS CASSTM
USPS® (Stati Uniti)1 gestisce il sistema CASSTM (Coding Accessibility Support System) per supportare e certificare i fornitori di servizi 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 utilizzi il servizio CASS, fornisci un indirizzo che includa la via e il numero civico oltre a città, stato e codice postale:
{
"address": {
"regionCode": "US",
"locality": "Mountain View",
"administrativeArea": "CA",
"postalCode": "94043",
"addressLines": ["1600 Amphitheatre Pkwy"]
},
"enableUspsCass": true
}
-
Google Maps Platform è un Licenziatario non esclusivo di Servizio postale® degli Stati Uniti. I seguenti marchi sono di proprietà di Servizio postale degli Stati Uniti® e vengono utilizzati previa autorizzazione: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩