Invia una richiesta di convalida dell'indirizzo

Invia una richiesta di convalida dell'indirizzo inviando una richiesta POST a uno dei seguenti endpoint:

• validateAddress (REST)
• ValidateAddress (gRPC)

Nota: questa documentazione utilizza REST per gli esempi, ma l'approccio è simile con gRPC.

La richiesta deve anche passare un corpo della richiesta JSON 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"]
  },
}

Prova!

Campi della richiesta di indirizzo

Il corpo della richiesta è costituito da un unico campo:

• address: un campo di tipo PostalAddress, che deve contenere 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 sottocampi:

• regionCode: consigliato. Si tratta di un campo facoltativo, ma se omesso, l'API Address Validation deducono la regione dall'indirizzo. Tuttavia, per ottenere risultati ottimali, includi regionCode se lo conosci. Per l'elenco delle regioni supportate, consulta Regioni supportate.
• addressLines: obbligatorio. Un array con indirizzi che descrivono la struttura inferiore dell'indirizzo.

Consulta PostalAddress nella guida di riferimento.

Opzione USPS CASS™

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

Nota: l'API Address Validation è confermata come servizio CASS-Certified™. Ciò significa che il servizio è stato confermato per la sua capacità di compilare le informazioni mancanti sull'indirizzo, di standardizzarlo e di aggiornarlo con l'indirizzo più aggiornato e preciso.

Solo per le regioni degli Stati Uniti e di Portorico, puoi attivare l'elaborazione CASS impostando enableUspsCass su true nel corpo della richiesta. Per ottenere risultati ottimali quando utilizzi CASS, fornisci un indirizzo che includa la via e il numero civico, nonché la città, lo stato e il codice postale:

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

Nota: se non hai bisogno dell'elaborazione CASS o se stai convalidando gli indirizzi al di fuori delle regioni degli Stati Uniti e di Portorico, Google sconsiglia di attivare questa funzionalità.

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 che vuoi utilizzare per effettuare la richiesta.

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

---

1. 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 dietro autorizzazione: United States Postal Service®, CASS™, CASS Certified™. ↩