Perché utilizzare l'API Address Validation
Con l'API Address Validation, puoi migliorare la prevedibilità delle consegne e ridurre gli errori di consegna, migliorando quindi la customer experience. Ciò avviene individuando gli indirizzi errati e ottenendo 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 convalida gli indirizzi per verificarne la correttezza. Consulta Creazione di funzionalità di convalida della posizione utilizzando Google Maps Platform nel Centro architetture per un confronto dettagliato.
Cosa puoi fare con l'API Address Validation
Con l'API Address Validation, puoi determinare se un indirizzo si riferisce a un luogo reale. Se l'indirizzo non si riferisce a un luogo reale, l'API può identificare i componenti potenzialmente errati che puoi presentare ai tuoi clienti per la correzione. Ecco un flusso di lavoro di esempio utilizzando 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 trasmette questo indirizzo come input all'API Address Validation.
L'API convalida e standardizza l'indirizzo: nella 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 restituisce l'API, puoi fornire le seguenti richieste al cliente:
Presenta un indirizzo consigliato al cliente per la conferma:
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 in singoli componenti ed esegue i seguenti controlli e correzioni:
- Corretta: fornisce controlli di convalida a livello di componente, incluse sub-premise, se disponibili.
- Completo: tenta di dedurre i componenti dell'indirizzo mancanti o errati.
- Ben formattato: consente di pulire e standardizzare il formato per i componenti degli indirizzi.
Prova la demo per vedere l'API Address Validation in azione.
Risorse
La tabella seguente riassume le risorse disponibili tramite l'API Address Validation e i dati che restituisce. Per dettagli specifici, consulta il riferimento per l'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:
Consulta Comprendere la risposta di convalida. |
Come utilizzare l'API Address Validation
| 1 | Prova la demo | Esplora la demo con una varietà 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 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 che seguono. |
| 4 | Richiedere la convalida di un indirizzo | Inizia con un indirizzo semplice e poi, per una maggiore precisione, puoi abilitare CASS (solo per indirizzi US e PR). Consulta Richiedere la convalida di un indirizzo. |
| 5 | Elaborare una risposta | La risposta dell'API Address Validation fornisce due proprietà, ognuna delle quali puoi utilizzare 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, consulta Librerie client.
Informazioni su CASSTM
United States Postal Service® (USPS®)1 gestisce il Coding Accuracy Support System (CASSTM) per supportare e certificare i fornitori di convalida degli indirizzi. Un servizio CASS CertifiedTM, come l'API Address Validation, è stato confermato per la sua capacità di compilare le informazioni mancanti di un indirizzo, standardizzarle e aggiornarle per fornire l'indirizzo più aggiornato e più accurato.
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 la sezione Convalidare un indirizzo.
Nell'ambito del suo utilizzo dei servizi USPS, USPS valuta le richieste di indirizzi creati artificialmente. Se USPS identifica un indirizzo inserito come creato artificialmente, Google è tenuta a interrompere la convalida degli indirizzi per il cliente e a segnalare a USPS le informazioni di contatto del cliente (nome e indirizzo), l'indirizzo di input pertinente e i dati di utilizzo aggregati. Se utilizzi l'API, accetti questi Termini specifici dei servizi.
Passaggi successivi
- Consulta le domande frequenti: vai alle Domande frequenti.
- Per controllare le aree di copertura: vai a Dettagli sulla copertura di paesi e regioni
- Elabora gli indirizzi in volumi elevati: vai a Utilizzare l'API Address Validation per elaborare gli indirizzi in volumi elevati.
-
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 con autorizzazione: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩