Panoramica dell'API Address Validation

Introduzione

L'API Address Validation è un servizio che accetta un indirizzo. Identifica i componenti dell'indirizzo e li convalida. Inoltre, standardizza l'indirizzo per l'invio per posta e trova le coordinate di latitudine/longitudine più conosciute. Se vuoi, per gli indirizzi negli Stati Uniti e a Portorico, puoi attivare il Coding Accuracy Support System (CASS™).

Perché utilizzare l'API Address Validation

Con l'API Address Validation, puoi migliorare la prevedibilità della consegna e ridurre gli errori di consegna, offrendo così una migliore customer experience. In questo modo puoi individuare gli indirizzi errati e ottenere una migliore consapevolezza delle caratteristiche degli indirizzi.

L'API Geocoding potrebbe essere 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 una funzionalità di convalida della posizione dell'edificio utilizzando Google Maps Platform nel Centro architettura.

Cosa puoi fare con l'API Address Validation

inputProva la demo

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 componenti potenzialmente errati che puoi presentare ai tuoi clienti per la correzione. Ecco un flusso di lavoro di esempio che utilizza l'API:

1. Il cliente inserisce un indirizzo: l'immagine seguente mostra un modulo di base che consente a un cliente di inserire un indirizzo, possibilmente nell'ambito di un flusso di pagamento.

2. L'app invia l'indirizzo all'API: l'applicazione passa questo indirizzo come input all'API Address Validation.

   

3. L'API convalida e standardizza l'indirizzo: nella risposta, l'API Address Validation restituisce l'indirizzo completo determinato dall'API oppure indica dove mancano informazioni.

4. 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 suoi singoli componenti e poi tenta le seguenti operazioni:

• Correzioni: fornisce controlli di convalida a livello di componente, inclusi i locali secondari, se disponibili.
• Completa: tenta di dedurre i componenti dell'indirizzo mancanti o errati.
• Formati: pulisce e standardizza il formato dei componenti dell'indirizzo.

Risorse

Nella tabella seguente sono riepilogate le risorse disponibili tramite l'API Address Validation insieme ai dati che restituisce. Per dettagli specifici, consulta il Riferimento API Address Validation.

Risorse di dati	Dati restituiti
Componenti dell'indirizzo in formato JSON. Vedi Convalidare un indirizzo.	Indirizzo completo e convalidato (se possibile). Stato di convalida di ogni componente dell'indirizzo. Dove disponibile per un indirizzo: Geocodice Precisione dell'indirizzo Dati dei servizi postali, se disponibili. Consulta la sezione Comprendere la risposta di convalida.

Come utilizzare l'API Address Validation

1	Prova la demo	Esplora la demo con una serie di moduli di indirizzo, sia corretti che errati. La demo offre un modo utile per esplorare sia i valori restituiti dal servizio sia la risposta dell'API in formato JSON.
2	Controllare la copertura	Consulta i dettagli della 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 riportate di seguito.
4	Richiedere la convalida di un indirizzo	Inizia con un indirizzo di base e poi, per una maggiore precisione, puoi attivare CASS (solo per indirizzi di Stati Uniti e Porto Rico). Consulta Richiedere una convalida dell'indirizzo.
5	Elaborare una risposta	La risposta dell'API Address Validation fornisce due proprietà, ognuna delle quali utilizzi in modi diversi. Consulta 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 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®)¹ utilizza il Coding Accuracy Support System (CASS™) per supportare e certificare i fornitori di convalida degli indirizzi. Un servizio con certificazione CASS™, come l'API Address Validation, è stato confermato per la sua capacità di compilare le informazioni mancanti in un indirizzo, standardizzarlo e aggiornarlo per fornirti l'indirizzo più attuale 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, vedi Convalidare un indirizzo.

Nell'ambito del nostro utilizzo dei servizi USPS, USPS valuta le richieste di indirizzi creati artificialmente. Se l'USPS identifica un indirizzo inserito come creato artificialmente, Google è tenuta a interrompere la convalida degli indirizzi per il cliente e deve comunicare all'USPS i dati di contatto del cliente (nome e indirizzo), l'indirizzo inserito pertinente e i dati di utilizzo aggregati. Utilizzando l'API, acconsenti a questi Termini di servizio specifici.

Passaggi successivi

• Prova la demo: vai a Demo
• Esamina le aree di copertura: vai a Dettagli sulla copertura di paesi e regioni
• Prova la prima richiesta di convalida: vai a Invia una richiesta di convalida dell'indirizzo
• Elaborare indirizzi ad alto volume: vai a Utilizzare l'API Address Validation per elaborare indirizzi ad alto volume