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:
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 o indica dove mancano informazioni.
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 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 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:
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
- 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 gli indirizzi ad alto volume
-
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. ↩