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:
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'app invia l'indirizzo all'API: l'applicazione passa questo indirizzo come input all'API Address Validation.
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.
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 aggiungere le informazioni 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:
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:
|
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
- Consulta le domande frequenti: consulta le Domande frequenti.
- Esaminare le aree di copertura: vai a Dettagli sulla copertura di paesi e regioni.
- Elaborare indirizzi ad alto volume: vai a Utilizzare l'API Address Validation per elaborare indirizzi ad alto volume.
-
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. ↩