Invia una richiesta di convalida dell'indirizzo

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"]
  },
}

Prova!

Campi di richiesta dell'indirizzo

Il corpo della richiesta è composto da un singolo campo:

• address: un campo di tipo PostalAddress, che deve contenere in almeno una voce in addressLines.

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. Questo è un campo facoltativo, ma se omesso, il valore L'API Address Validation deduce la regione dall'indirizzo. Tuttavia, per la migliore tra i risultati, includi regionCode, 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.

Opzione USPS CASSTM

United States Postal Service® (USPS®)¹ gestisce il Coding Accuracy Support System (CASS™) per supportare e certificare i fornitori di convalida degli indirizzi.

Solo per le regioni degli Stati Uniti e di Portorico, puoi attivare l'elaborazione CASS impostando enableUspsCass su 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

L'Explorer API ti consente di effettuare richieste di esempio per familiarizzare con l'API e le relative opzioni.

1. Seleziona l'icona dell'API sul lato destro della pagina.

2. Se vuoi, espandi Mostra parametri standard e imposta il parametro fields sulla maschera del campo.

3. Se vuoi, modifica il corpo della richiesta.

4. Seleziona il pulsante Esegui. Nella finestra di dialogo, scegli l'account da utilizzare per effettuare la richiesta.

5. Nel riquadro Explorer API, seleziona l'icona Espandi, , per espandere la finestra Explorer API.