Perché utilizzare l'API Address Validation
Con l'API Address Validation, 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 conferma o corregge l'indirizzo: a seconda di ciò che restituisce l'API, puoi fornire al cliente i seguenti prompt: A. Conferma l'indirizzo consigliato. B. Fornisci le informazioni mancanti. C. Correggi l'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 singoli componenti e poi tenta quanto segue:
- Corregge: fornisce controlli di convalida a livello di componente, inclusi i subpresidi, se disponibili.
- Completa: tenta di dedurre i componenti dell'indirizzo mancanti o errati.
- Formati: pulisce e standardizza il formato dei componenti dell'indirizzo.
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 | Controllare 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 di 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
- Prova la demo: vai a Demo
- Esamina le aree di copertura: vai a Dettagli sulla copertura per paese e regione.
- Prova la tua prima richiesta di convalida: vai a Inviare una richiesta di convalida dell'indirizzo.
- 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™. ↩