Perché utilizzare l'API Address Validation
Con l'API Address Validation, puoi migliorare la prevedibilità della consegna e ridurre gli errori di consegna, migliorando così l'esperienza del cliente. A tal fine, cerca di individuare gli indirizzi errati e di ottenere una migliore consapevolezza delle caratteristiche degli indirizzi.
Se non hai bisogno di convalidare i singoli componenti dell'indirizzo per la tua richiesta, l'API Geocoding potrebbe essere più adatta alle tue esigenze. L'API Geocoding converte gli indirizzi in coordinate di latitudine/longitudine, mentre l'API Indirizzo Validation convalida gli indirizzi per la correttezza. Per i dettagli, consulta la sezione Come funziona l'API Address Validation e la panoramica sull'API Geocoding.
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 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 flusso di lavoro di esempio che utilizza l'API:
Il cliente inserisce un indirizzo: la seguente immagine mostra un semplice modulo che consente al 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 determinato 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 le seguenti richieste:
Presenta al cliente un indirizzo consigliato da confermare:
Chiedi al cliente di aggiungere informazioni mancanti:
Chiedi all'utente di correggere l'indirizzo se l'API non è in grado di convalidare l'indirizzo di input 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. Divide l'indirizzo in singoli componenti, quindi esegue i seguenti controlli e correzioni:
- Fornisce controlli di convalida a livello di componente, inclusi i sub-premise, se disponibili.
- Tenta di dedurre i componenti dell'indirizzo mancanti o errati.
- Pulisce e standardizza il formato per i componenti degli indirizzi.
Prova la demo per vedere l'API Address Validation in azione.
Risorse
La tabella seguente riepiloga le risorse disponibili tramite l'API Address Validation e i dati che restituisce. Per dettagli specifici, consulta il riferimento API Validation dell'indirizzo.
| Risorse di dati | Dati restituiti |
|---|---|
|
Analizza i componenti in formato JSON. Vedi Convalidare un indirizzo. |
Indirizzo completo e convalidato (se possibile). Stato di convalida di ciascun componente dell'indirizzo. Se disponibile per un indirizzo:
Consulta la sezione Comprendere la risposta di convalida. |
Come utilizzare l'API Address Validation
| 1 | Prova la demo | Esplora la demo con una varietà di moduli di indirizzo, corretti e non corretti. La demo fornisce un modo utile per esplorare sia i valori di ritorno dal servizio sia la risposta API in formato JSON. |
| 2 | Configurazione. | Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni seguenti. |
| 3 | Convalidare un indirizzo | Inizia con un indirizzo semplice e poi, per una maggiore precisione, puoi abilitare il CASS (solo per indirizzi statunitensi e PR). Vedi Convalidare un indirizzo. |
| 4 | Elaborare una risposta | La risposta dell'API Address Validation fornisce due proprietà, ognuna delle quali utilizzerai in modi diversi. Consulta la sezione Comprendere la risposta di convalida. |
| 5 | Migliorare l'accuratezza della convalida | Puoi aiutarci a migliorare l'accuratezza degli indirizzi fornendo feedback sulle risposte dell'API Address Validation. Vedi Fornire feedback sulla convalida dell'indirizzo. |
Librerie client disponibili
Per un elenco delle librerie client disponibili per l'API Address Validation, consulta le librerie client.
Informazioni su CASSTM
Il servizio postale degli Stati Uniti® (USPS®)1 gestisce il Sistema di supporto per la precisione della codifica (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 da un indirizzo, standardizzarlo e aggiornarlo per darti l'indirizzo più attuale e accurato.
Il servizio CASS non è abilitato per impostazione predefinita ed è supportato solo per le regioni "US" e "PR". Per abilitare il CASS, imposta enableUspsCass su true come parte di una richiesta di convalida. Per ulteriori informazioni, consulta la pagina 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 in modo artificiale, Google è tenuta a interrompere la convalida degli indirizzi per il cliente e a segnalare le informazioni di contatto del cliente (nome e indirizzo), l'indirizzo di input pertinente e i dati sull'utilizzo aggregati a USPS. Utilizzando l'API, accetti questi Termini specifici di servizio.
Passaggi successivi
- Consulta le Domande frequenti: leggi 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 utilizzati con autorizzazione: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩