Invia una richiesta di convalida dell'indirizzo

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

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 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 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, includi regionCode, 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
}

  1. 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.