Invia una richiesta di convalida dell'indirizzo

Sviluppatori dello Spazio economico europeo (SEE)

Invia una richiesta di Address Validation inviando una richiesta POST a uno dei seguenti endpoint:

La richiesta deve inoltre 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"]
  },
}

Explorer API ti consente di effettuare richieste in tempo reale per acquisire familiarità con l'API e le relative opzioni:

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. Questo è un campo facoltativo, ma se viene 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 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®)1 gestisce il Coding Accuracy Support System (CASS™) per supportare e certificare i fornitori di Address Validation.

Solo per le regioni US e PR, 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, oltre alla città, allo stato e al 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 per acquisire familiarità con l'API e le relative opzioni.

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

  2. Se vuoi, modifica i parametri della richiesta.

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

  4. Nel riquadro Explorer API, seleziona l'icona Schermo intero fullscreen 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™. ↩