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 passare un corpo della richiesta JSON alla richiesta 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 di richiesta 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 sottocampi:

  • regionCode - Consigliato. Questo è un campo facoltativo, ma se omesso, l'API Address Validation deduce la regione dall'indirizzo. Tuttavia, per ottenere risultati ottimali, includi regionCode, se lo conosci. Per l'elenco delle regioni supportate, consulta l'articolo sulle regioni supportate.
  • addressLines - Obbligatorio. Un array con indirizzi che descrivono la struttura inferiore dell'indirizzo.
Vedi PostalAddress nella guida di riferimento.

Opzione USPS CASSTM

Il servizio postale statunitense (USPS®)1 gestisce il sistema di supporto della codifica dell'accuratezza (CASSTM) 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 CASS, fornisci un indirizzo che includa la via e il numero civico 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 consente di effettuare richieste di esempio in modo da acquisire familiarità con le opzioni API e API.

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

  2. (Facoltativo) Modifica il Corpo della richiesta.

  3. Seleziona il pulsante Esegui. Nella finestra di dialogo, scegli l'account che vuoi usare per effettuare la richiesta.

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

  1. Google Maps Platform è un Licenziatario non esclusivo del Servizio postale degli Stati Uniti®. I seguenti marchi sono di proprietà di Servizi postali degli Stati Uniti® e vengono utilizzati con autorizzazione: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩