Panoramica dell'API Address Validation

Sviluppatori dello Spazio economico europeo (SEE)

Introduzione

L'API Address Validation è un servizio che accetta un indirizzo. Identifica i componenti dell'indirizzo e li convalida. Inoltre, standardizza l'indirizzo per la spedizione postale e trova le coordinate di latitudine/longitudine più conosciute. Facoltativamente, 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à delle consegne e ridurre gli errori, offrendo così un'esperienza cliente migliore. Per farlo, devi individuare gli indirizzi errati e ottenere una migliore conoscenza delle caratteristiche degli indirizzi.

Altre considerazioni

L'API Address Validation convalida gli indirizzi per verificarne la correttezza. L'API Geocoding converte gli indirizzi in coordinate di latitudine e longitudine. Per un confronto dettagliato, consulta la sezione Creare funzionalità di convalida della località utilizzando Google Maps Platform nel Centro architetturale.

L'API Geocoding potrebbe essere più adatta alle tue esigenze se non devi convalidare i singoli componenti dell'indirizzo o se hai bisogno di dettagli sulla destinazione iperlocali, come ingressi degli edifici, contorni degli edifici e punti di navigazione.

L'API Geocoding v4 introduce il metodo SearchDestinations, che restituisce le coordinate per gli ingressi degli edifici, i punti di navigazione e i contorni degli edifici. Per maggiori dettagli, consulta la sezione Cercare le destinazioni dell'API Geocoding v4.

Cosa puoi fare con l'API Address Validation

Prova 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 i componenti potenzialmente errati che puoi presentare ai tuoi clienti per correggerli. Di seguito è riportato 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.

    L'indirizzo inserito dal cliente.

  3. 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.

  4. Il cliente conferma o corregge l'indirizzo : a seconda di ciò che restituisce l'API, puoi fornire al cliente le seguenti richieste: A. Conferma l'indirizzo consigliato. B. Fornisci le informazioni mancanti. C. Correggi l'indirizzo.

    Chiedi al cliente di confermare l'indirizzo determinato dall'API.Chiedi al cliente di inserire i dati dell'indirizzo mancanti. Chiedi al cliente di correggere le informazioni dell'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 di:

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

Risorse

La tabella seguente riepiloga le risorse disponibili tramite l'API Address Validation e i dati che restituisce. Per dettagli specifici, consulta il riferimento dell'API Address Validation.

Risorse dati Dati restituiti

Componenti dell'indirizzo in formato JSON.

Consulta 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 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, sia corretti che errati. La demo fornisce un modo utile per esplorare sia i valori restituiti dal servizio sia la risposta API in formato JSON.
2 Verifica la copertura Esamina i dettagli della copertura per vedere quali paesi e regioni supporta l'API Address Validation.
3 Configurazione Inizia con Configura il progetto Google Cloud e completa le istruzioni riportate di seguito.
4 Richiedi una convalida dell'indirizzo Inizia con un indirizzo di base e poi, per una maggiore precisione, puoi attivare CASS (solo per gli indirizzi negli Stati Uniti e a Portorico). Consulta Richiedere una convalida dell'indirizzo.
5 Elabora una risposta La risposta dell'API Address Validation fornisce due proprietà, ognuna delle quali viene utilizzata in modi diversi. Consulta Comprendere una risposta di base.
6 Migliora la precisione della convalida Puoi contribuire a migliorare la precisione dell'indirizzo 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 utilizza 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 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, 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 di input 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 di input pertinente e i dati di utilizzo aggregati. Utilizzando l'API, accetti questi Termini di servizio specifici.

Passaggi successivi

  1. 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™. ↩