Panoramica dell'API Address Validation

Panoramica della convalida degli indirizzi

L'API Address Validation è un servizio che accetta un indirizzo. Identifica i componenti degli indirizzi e li convalida. Inoltre, standardizza l'indirizzo per posta e trova le sue coordinate di latitudine e longitudine più note. Facoltativamente, per gli indirizzi negli Stati Uniti e a Portorico, puoi attivare il CASSTM (Coding Identification Support System).

Perché utilizzare l'API Address Validation

Con l'API Address Validation, puoi migliorare la prevedibilità delle consegne e ridurre gli errori di consegna, migliorando così l'esperienza del cliente. A tal fine, individua gli indirizzi errati e acquisisci una maggiore consapevolezza delle caratteristiche dell'indirizzo.

L'API Geocoding potrebbe essere più adatta alle tue esigenze se non devi convalidare i singoli componenti dell'indirizzo. L'API Geocoding converte gli indirizzi in coordinate di latitudine/longitudine, mentre l'API Address Validation ne convalida la correttezza. Per un confronto dettagliato, consulta Creazione di funzionalità di convalida della località utilizzando Google Maps Platform nel Centro architetture.

Cosa puoi fare con l'API Address Validation

Con l'API Address Validation, puoi determinare se un indirizzo fa riferimento a un luogo reale. Se l'indirizzo non fa riferimento a un luogo reale, l'API può identificare componenti potenzialmente errati che puoi presentare ai clienti per la correzione. Di seguito è riportato un esempio di flusso di lavoro che utilizza l'API:

  1. Il cliente inserisce un indirizzo: l'immagine seguente mostra un semplice modulo che consente a un cliente di inserire un indirizzo, possibilmente nell'ambito di un flusso di pagamento.
    L'indirizzo inserito dal cliente.

  2. L'app invia l'indirizzo all'API: l'applicazione passa questo indirizzo come input all'API Address Validation.

  3. L'API convalida e standardizza l'indirizzo: nella sua risposta, l'API Address Validation restituisce l'indirizzo completo come determinato dall'API oppure indica dove mancano le informazioni.

  4. Il cliente corregge o conferma l'indirizzo consigliato: a seconda di ciò che restituisce l'API, puoi fornire le seguenti richieste al cliente:

    • Presenta un indirizzo consigliato al cliente per confermare:
      Chiedi al cliente di confermare l'indirizzo come determinato dall'API.

    • Chiedi al cliente di aggiungere le informazioni mancanti:
      Chiedi al cliente di inserire i dati dell'indirizzo mancanti.

    • Chiedi all'utente di correggere l'indirizzo se l'API non è in grado di convalidare l'indirizzo inserito a causa di informazioni mancanti o errate:
      Chiedi al cliente di correggere i dati dell'indirizzo.

Come funziona l'API Address Validation

La convalida degli indirizzi accetta una richiesta POST con l'indirizzo sotto forma di corpo JSON. Separa l'indirizzo nei suoi singoli componenti, dopodiché esegue i seguenti controlli e correzioni:

  • Corretto: fornisce controlli di convalida a livello di componente, incluse le sedi secondarie, se disponibili.
  • Completato: tenta di dedurre i componenti dell'indirizzo mancanti o errati.
  • Ben formattato: ripulisce e standardizza il formato per i componenti dell'indirizzo.

Prova la demo per vedere l'API Address Validation in azione.

Risorse

La seguente tabella riassume le risorse disponibili tramite l'API Address Validation e i dati che restituisce. Per dettagli specifici, consulta il riferimento dell'API Address Validation.

Risorse di dati Dati restituiti

Componenti degli indirizzi in formato JSON.

Vedi Convalidare un indirizzo.

Indirizzo completo e convalidato (se possibile).

Stato di convalida di ogni componente dell'indirizzo.

Se disponibile per un indirizzo:

  • Geocodifica
  • Precisione degli indirizzi
  • Dati dei servizi postali, se disponibili.

Vedi Comprendere la risposta di convalida.

Come utilizzare l'API Address Validation

1 Prova la demo Esplora la demo con una serie di moduli per gli indirizzi, corretti e non corretti. La demo fornisce un modo utile per esplorare sia i valori restituiti dal servizio sia la risposta dell'API in formato JSON.
2 Controllare la copertura Esamina i dettagli di copertura per vedere quali paesi e regioni sono supportati dall'API Address Validation.
3 Configurazione Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni seguenti.
4 Richiedere una convalida dell'indirizzo Inizia con un indirizzo semplice e poi, per una maggiore precisione, puoi abilitare CASS (solo per indirizzi di Stati Uniti e PR). Vedi Richiedere una convalida dell'indirizzo.
5 Elaborare una risposta La risposta dell'API Address Validation fornisce due proprietà, ciascuna delle quali viene utilizzata in modi diversi. Vedi Comprendere una risposta di base.
6 Migliorare l'accuratezza della convalida Puoi contribuire a migliorare l'accuratezza degli indirizzi fornendo feedback sulle risposte dell'API Address Validation. Vedi Gestire gli indirizzi aggiornati.

Librerie client disponibili

Per un elenco delle librerie client disponibili per l'API Address Validation, vedi Librerie client.

Informazioni su CASSTM

Il servizio postale statunitense (USPS®)1 gestisce il sistema di supporto della codifica (CASSTM) per supportare e certificare i fornitori di servizi di convalida degli indirizzi. È stata confermata la capacità di un servizio CASS CertifiedTM, come l'API Address Validation, di inserire informazioni mancanti da un indirizzo, standardizzarle e aggiornarle per fornirti l'indirizzo più aggiornato e preciso.

CASS non è abilitato per impostazione predefinita ed è supportato solo per le regioni "US" e "PR". Per abilitare CASS, imposta enableUspsCass su true come parte di una richiesta di convalida. Per ulteriori informazioni, consulta Convalida di un indirizzo.

Nell'ambito del suo utilizzo dei servizi USPS, USPS valuta le richieste di indirizzi creati artificialmente. Se USPS identifica un indirizzo di input creato artificialmente, Google deve interrompere la convalida degli indirizzi per il cliente e deve segnalare a USPS le informazioni di contatto del cliente (nome e indirizzo), l'indirizzo di input pertinente e i dati aggregati sull'utilizzo. Utilizzando l'API, accetti i presenti Termini specifici dei servizi.

Passaggi successivi


  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.