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