Perché utilizzare l'API Address Validation
Con l'API di convalida degli indirizzi, puoi migliorare la prevedibilità di recapito e ridurre i fallimenti di recapito, offrendo così una migliore esperienza cliente. Puoi farlo rilevando gli indirizzi errati e acquisendo 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 e longitudine. L'API Address Validation convalida gli indirizzi per verificarne la correttezza. Per un confronto dettagliato, consulta la sezione Creare la funzionalità di convalida della posizione utilizzando Google Maps Platform nel Centro Architettura.
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 tuoi clienti per la correzione. Ecco un flusso di lavoro di esempio che utilizza l'API:
Il cliente inserisce un indirizzo: l'immagine seguente mostra un modulo di base che consente a un cliente di inserire un indirizzo, eventualmente 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 risposta, l'API Address Validation restituisce l'indirizzo completo come stabilito dall'API o indica dove mancano le informazioni.
Il cliente corregge o conferma l'indirizzo consigliato: a seconda di ciò che restituisce l'API, puoi fornire al cliente i seguenti prompt:
Presenta un indirizzo consigliato da confermare al cliente:
Chiedi al cliente di aggiungere le informazioni mancanti:
Chiedi all'utente di correggere l'indirizzo se l'API non è in grado di convalidarlo 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 singoli componenti e poi esegue i seguenti controlli e correzioni:
- Corretta: fornisce controlli di convalida a livello di componente, inclusi i subpresidi, se disponibili.
- Completa: tenta di dedurre i componenti dell'indirizzo mancanti o errati.
- Formattato correttamente: pulisce e standardizza il formato dei componenti dell'indirizzo.
Prova la demo per vedere l'API Address Validation in azione.
Risorse
La tabella seguente riassume le risorse disponibili tramite l'API Address Validation insieme ai dati restituiti. Per informazioni specifiche, consulta la documentazione di riferimento dell'API Address Validation.
| Risorse di dati | Dati restituiti |
|---|---|
|
Componenti di indirizzo 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 la sezione Informazioni sulla risposta di convalida. |
Come utilizzare l'API Address Validation
| 1 | Prova la demo | Esplora la demo con una serie di formati di indirizzi, 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 | Verificare la copertura | Esamina i dettagli sulla copertura per scoprire quali paesi e regioni sono supportati dall'API Address Validation. |
| 3 | Configurazione | Inizia con Configurare il progetto Google Cloud e completa le istruzioni che seguono. |
| 4 | Richiedere la convalida di un indirizzo | Inizia con un indirizzo di base e, per una maggiore precisione, puoi attivare CASS (solo per indirizzi negli Stati Uniti e a Portorico). Consulta Richiedere la convalida di un indirizzo. |
| 5 | Elaborare una risposta | La risposta dell'API Address Validation fornisce due proprietà, ciascuna delle quali viene utilizzata in modi diversi. Consulta Informazioni su 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 Gestire gli indirizzi aggiornati. |
Librerie client disponibili
Per un elenco delle librerie client disponibili per l'API Address Validation, consulta Librerie client.
Informazioni su CASS™
United States Postal Service® (USPS®)1 gestisce il Coding Accuracy Support System (CASS™) per supportare e certificare i fornitori di convalida degli indirizzi. Un servizio CASS Certified™, come l'API Address Validation, è stato verificato per la sua capacità di compilare le informazioni mancanti in un indirizzo, standardizzarlo e aggiornarlo per fornirti l'indirizzo più aggiornato e preciso.
CASS non è attivato per impostazione predefinita ed è supportato solo per le regioni "US" e "PR". Per attivare CASS, imposta enableUspsCass su true nell'ambito di una richiesta di convalida. Per ulteriori informazioni, consulta
Convalidare un indirizzo.
Nell'ambito del nostro 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 deve segnalare a USPS i dati di contatto del cliente (nome e indirizzo), l'indirizzo inserito pertinente e i dati di utilizzo aggregati. Se utilizzi l'API, accetti Termini di servizio specifici.
Passaggi successivi
- Esamina le domande frequenti: vai a Domande frequenti
- Esamina le aree di copertura: vai a Dettagli sulla copertura per paese e regione.
- Elaborare indirizzi con un volume elevato: vai a Utilizzare l'API Address Validation per elaborare indirizzi con un volume elevato
-
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 dietro autorizzazione: United States Postal Service®, CASS™, CASS Certified™. ↩