Panoramica della verifica dell'indirizzo

Sviluppatori dello Spazio economico europeo (SEE)

Perché utilizzare Address Validation nell'API Maps JavaScript?

La libreria Address Validation accetta un indirizzo come input per identificare e convalidare i componenti dell'indirizzo. Inoltre, standardizza l'indirizzo per le spedizioni postali e trova le coordinate di latitudine/longitudine più note. Facoltativamente, per gli indirizzi negli Stati Uniti e a Portorico, puoi attivare il Coding Accuracy Support System (CASS™).

Con l'API Address Validation, puoi migliorare la prevedibilità delle consegne e ridurre gli errori di consegna, offrendo così una migliore customer experience. A questo scopo, individua gli indirizzi errati e ottieni una migliore conoscenza delle caratteristiche degli indirizzi.

Cosa puoi fare con Address Validation nell'API Maps JavaScript

Con Address Validation nell'API Maps JavaScript, 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 esempio di flusso di lavoro:

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

    L'indirizzo inserito dal cliente.
  2. L'app invia l'indirizzo all'API: l'applicazione passa questo indirizzo utilizzando il metodo fetchAddressValidation.

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

  4. Il cliente conferma o corregge l'indirizzo: a seconda di ciò che l'API restituisce, puoi fornire al cliente i seguenti prompt:

    1. Conferma l'indirizzo consigliato.
    2. Fornisci le informazioni mancanti.
    3. Correggi l'indirizzo.
    Il cliente può confermare l'indirizzo corretto. Il cliente può fornire le informazioni mancanti. Il cliente può correggere l'indirizzo.

Come funziona Address Validation nell'API Maps JavaScript

Quando viene effettuata una chiamata a fetchAddressValidation, l'API tenta di eseguire le seguenti operazioni:

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

Informazioni su CASS™

United States Postal Service® (USPS®)1 utilizza il Coding Accuracy Support System (CASS™) per supportare e certificare i fornitori di Address Validation. Un servizio con certificazione CASS™, come l'API Address Validation, è stato confermato per la sua capacità di inserire le informazioni mancanti in un indirizzo, standardizzarlo e aggiornarlo per fornirti l'indirizzo più aggiornato e accurato.

CASS non è abilitato 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 saperne di più, consulta Convalida 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 specifici dei servizi.

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