Panoramica dell'API Address Validation

Panoramica della convalida degli indirizzi

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

Perché utilizzare l'API Address Validation

L'API Address Validation consente di migliorare la prevedibilità delle consegne e di ridurre gli errori di consegna, migliorando così l'esperienza del cliente. Per farlo, puoi rilevare gli indirizzi errati e acquisire una maggiore consapevolezza delle caratteristiche degli indirizzi.

L'API Geocoding potrebbe essere una soluzione 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 i componenti potenzialmente errati che puoi presentare ai clienti per correggere. 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 o indica dove mancano informazioni.

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

    • Presenta un indirizzo consigliato che il cliente possa 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 mancanti dell'indirizzo.

    • 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 dell'indirizzo accetta una richiesta POST con l'indirizzo sotto forma di corpo JSON. Separa l'indirizzo nei suoi singoli componenti, quindi 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: pulisce 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, insieme ai dati che restituisce. Per maggiori dettagli, consulta il riferimento dell'API Address Validation.

Risorse di dati Dati restituiti

Indirizzo dei componenti 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.

Consulta Comprendere la risposta di convalida.

Come utilizzare l'API Address Validation

1 Prova la demo Esplora la demo con vari moduli per l'indirizzo, sia corretti che errati. La demo fornisce un modo utile per esplorare sia i valori restituiti dal servizio sia la risposta dell'API in formato JSON.
2 Controlla la copertura Esamina i dettagli della copertura per conoscere i paesi e le regioni supportati dall'API Address Validation.
3 Configurazione Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni riportate di seguito.
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. Consulta la sezione Fornire feedback sulla convalida degli indirizzi.

Librerie client disponibili

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

Informazioni su CASSTM

Il Servizio postale degli Stati Uniti (USPS®)1 gestisce il Coding Accessibility Support System (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 le informazioni mancanti in 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 Convalidare un indirizzo.

Nell'ambito dell'utilizzo dei servizi USPS, USPS valuta le richieste di indirizzi creati artificialmente. Se USPS identifica un indirizzo di input come 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), il relativo indirizzo di input 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à del Servizio postale degli Stati Uniti® e vengono utilizzati con autorizzazione: United States Postal Service®, CASSTM, CASS CertifiedTM.