Panoramica della verifica dell'indirizzo

Sviluppatori nello Spazio economico europeo (SEE)

Se il tuo indirizzo di fatturazione si trova nello Spazio economico europeo, a partire dall'8 luglio 2 2025 al tuo utilizzo dei Servizi si applicheranno i Termini di servizio di Google Maps Platform per il SEE. La funzionalità varia in base alla regione. Scopri di più.

Questo prodotto o questa funzionalità è in anteprima (pre-release). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le offerte pre-GA sono coperte dai Termini specifici di servizio di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Perché utilizzare Address Validation nell'API Maps JavaScript?

La libreria Address Validation prende un indirizzo come input per identificare e convalidare i componenti dell'indirizzo. Inoltre, standardizza l'indirizzo per l'invio per posta 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™).

Con l'API Address Validation, puoi migliorare la prevedibilità di recapito e ridurre gli errori di recapito, offrendo così un'esperienza migliore ai clienti. A questo scopo, puoi rilevare gli indirizzi errati e ottenere una conoscenza più approfondita 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 Convalida della posizione degli edifici utilizzando Google Maps Platform nell'Architecture Center.

Che cosa puoi fare con Address Validation nell'API Maps JavaScript

Con la funzionalità di convalida dell'indirizzo nell'API Maps JavaScript, 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 sbagliati che puoi presentare ai tuoi clienti per la correzione. Ecco un flusso di lavoro di esempio:

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

   

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 risposta, l'API Address Validation restituisce l'indirizzo completo come stabilito dall'API o indica dove mancano le informazioni.

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

   1. Conferma l'indirizzo consigliato.
   2. Fornisci le informazioni mancanti.
   3. Correggi l'indirizzo.
   

Come funziona la verifica dell'indirizzo nell'API Maps JavaScript

Quando viene effettuata una chiamata a fetchAddressValidation, l'API tenta quanto segue:

• Correggere: 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.

Informazioni su CASS™

United States Postal Service® (USPS®)¹ 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 confermato 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, vedi 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 è obrigada 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 i seguenti Termini specifici del servizio.

Passaggi successivi

• Inizia a utilizzare la convalida degli indirizzi nell'API Maps JavaScript

---

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