Acquisizione e convalida degli indirizzi

La funzionalità di acquisizione e convalida degli indirizzi è un toolkit di servizi di mobilità che aiuta a risolvere una serie di problemi comuni relativi all'indirizzamento della consegna, come l'inserimento di indirizzi imprecisi da parte dei consumatori, indirizzi non recapitabili e la necessità di modifiche ai luoghi di consegna.

Tali servizi includono:

  • API Places: semplifica l'inserimento dell'indirizzo per gli utenti finali e fornisce informazioni sui punti di interesse che possono essere utilizzate per scopi di pianificazione del percorso.
  • API Address Validation: Determina se un indirizzo si riferisce a un luogo di consegna reale e fornisce metadati aggiuntivi a livello di indirizzo.
  • API Geocoding: Fornisce la latitudine e la longitudine per un determinato indirizzo.

Questo documento descrive come utilizzare questi servizi.

Informazioni sull'acquisizione e la convalida dell'indirizzo

Informazioni sull'indirizzo accurate e dettagliate sono fondamentali per le operazioni di consegna perché influiscono sulla qualità di tutte le attività a valle che dipendono da queste informazioni. Che tu ottenga gli indirizzi tramite un'applicazione rivolta agli utenti o da partner upstream utilizzando un'API, i servizi di mobilità di Google possono aiutarti in questo passaggio.

Che tu ottenga gli indirizzi tramite un'applicazione rivolta agli utenti o da partner upstream utilizzando un'API, i servizi di mobilità di Google possono aiutarti con l'acquisizione degli indirizzi nel seguente modo:

  • Migliora l'esperienza dei consumatori:fornisci ai tuoi utenti gli strumenti per assicurarti che possano fornire un indirizzo corretto e che i loro pacchi vengano consegnati nel posto giusto.

  • Migliora la produttività dei conducenti: riduci il tempo che i conducenti trascorrono a cercare gli indirizzi di consegna e riduci la necessità di tentativi di consegna ripetuti.

Acquisire l'indirizzo

L'API Places contiene il servizio Place Autocomplete. Questo servizio fornisce funzionalità di completamento automatico per le ricerche geografiche basate su testo restituendo luoghi, come attività, indirizzi e punti d'interesse, man mano che l'utente inserisce un indirizzo.

Per le applicazioni rivolte agli utenti che prevedono l'ottenimento di un indirizzo di consegna, ad esempio un sito di spedizione o di consumo online o un portale per i dipendenti del negozio, semplifica l'inserimento e la selezione dell'indirizzo per i tuoi clienti utilizzando il completamento automatico dei luoghi.

Ad esempio, supponiamo che un utente richieda il ritiro di un pacco e inserisca la località di ritiro. Il completamento automatico dei luoghi consente di fornire un indirizzo inserendo solo pochi caratteri e selezionando da un elenco corrispondente.

L'API Places fornisce anche modi per limitare i risultati di ricerca, in modo che gli sviluppatori possano assicurarsi che gli indirizzi suggeriti siano in linea con le località servite dalla tua attività.

Convalidare l'indirizzo

Dopo aver acquisito un indirizzo, tramite l'inserimento diretto da parte dell'utente o tramite un'API, assicurati che il cliente abbia fornito un indirizzo corretto. Ciò significa un indirizzo privo di imprecisioni, come componenti dell'indirizzo mancanti o errori di battitura. La convalida dell'indirizzo consente di ridurre gli errori di consegna rilevando gli indirizzi errati e migliora la prevedibilità della consegna grazie a una migliore conoscenza dei dettagli dell'indirizzo.

L'API Address Validation convalida i componenti dell'indirizzo, lo normalizza per l'invio per posta e trova la posizione più conosciuta. Può aiutarti a capire se un indirizzo si riferisce a un luogo reale. Se l'indirizzo non si riferisce a un luogo reale, può identificare componenti potenzialmente errati, consentendo agli utenti di correggerli.

Se l'API Address Validation determina che l'indirizzo è errato o si riferisce a una località non raggiungibile, puoi chiedere all'utente di correggerlo. Se ottieni l'indirizzo utilizzando una chiamata API, puoi rifiutarlo.

Consenti la conferma della posizione dell'indirizzo

Dopo che un utente ha inserito o selezionato un indirizzo e lo hai convalidato, utilizza Google Maps Platform per fornire una mappa e un indicatore per indicare la posizione dell'indirizzo.

Utilizza l'API Geocoding per determinare le coordinate geografiche dell'indirizzo. Oltre alla posizione, l'API Geocoding restituisce anche i componenti dell'indirizzo, che puoi utilizzare per ottenere le parti mancanti dell'indirizzo necessarie per le correzioni. Fornisce anche il tipo di posizione, che indica la precisione delle coordinate recuperate dall'API.

La posizione geocodificata può essere utilizzata anche per altri scopi, ad esempio per assegnare la consegna a un autista nella sequenza ottimale. Per maggiori dettagli, vedi Ottimizzazione itinerari.

Utilizzare i servizi Google Mobility per l'acquisizione degli indirizzi

Questa sezione fornisce informazioni di base su come implementare l'acquisizione e la convalida degli indirizzi. Questi passaggi presuppongono che tu abbia configurato un progetto nella console API di Google e che siano abilitati gli account di servizio e la fatturazione corretti. Per dettagli specifici sui servizi Google Mobility, consulta la documentazione di Fleet Engine per configurare il progetto.

Attivare le funzionalità di inserimento degli indirizzi

  1. Attiva l'API Places nella sezione API e servizi della console API di Google. L'API Places include il servizio Place Autocomplete.
  2. Consulta la documentazione di Place Autocomplete per scoprire altre funzionalità che puoi utilizzare, ad esempio la sezione Parametri facoltativi. Ad esempio:
    • Il parametro components limita l'output a determinati paesi.
    • Il parametro types limita i risultati a determinati tipi di località, come indirizzi e persino lingue di input consentite dall'utente.
  3. Per semplificare l'implementazione di un modulo di indirizzo, Google Maps Platform offre un Quick Builder all'interno della console Google API.

Convalidare l'indirizzo di consegna

  1. Attiva l'API Address Validation nella sezione API e servizi della console API di Google.
  2. Consulta la documentazione dell'API Address Validation per comprendere i vari dati che puoi utilizzare per valutare la qualità dell'indirizzo e mostrare consigli agli utenti.

Consenti la conferma del luogo di ritiro o consegna

  1. Crea una mappa interattiva per i tuoi utenti sulle tue piattaforme preferite per dispositivi mobili e web. Per informazioni specifiche, consulta la documentazione dell'API Maps JavaScript e passa alle istruzioni per altre piattaforme.
  2. Ottieni il geocodice dell'indirizzo dall'API Address Validation o passando l'ID luogo da Place Autocomplete all'API Geocoding e aggiungi un indicatore nella posizione.
  3. Per consentire all'utente di modificare le coordinate di consegna, rendi i tuoi indicatori trascinabili. Consulta la documentazione sui comportamenti dei marcatori (Android, iOS, web).
  4. Recupera il geocodice della posizione corretta del segnaposto. Puoi anche passare il geocodice aggiornato all'API Reverse Geocoding per recuperare l'indirizzo corrispondente. Puoi quindi valutare i componenti dell'indirizzo e l'accuratezza della nuova posizione.

Fornire un contesto aggiuntivo sugli indirizzi di consegna

Disporre di dati contestuali dettagliati sugli indirizzi di consegna è un passaggio successivo essenziale una volta determinato un indirizzo. Con queste informazioni puoi:

  • Migliora la produttività dei conducenti: assicurati che i tuoi conducenti abbiano tutte le informazioni per completare le consegne in modo efficiente e senza problemi. Se combinate con le funzionalità di altri servizi di mobilità di Google, puoi assicurarti che gli autisti arrivino nel posto giusto al momento giusto.
  • Riduzione dei costi: portare in modo efficiente l'autista nel posto giusto e ridurre le consegne ripetute può anche ridurre i costi di manodopera e del carburante per la tua flotta.
  • Scalare le operazioni: tutte le funzionalità di acquisizione degli indirizzi utilizzano il database geospaziale mondiale di Google, che fornisce una copertura granulare ovunque tu espanda la tua attività.

I servizi Google Mobility possono essere utilizzati per ottenere una serie di dati contestuali su indirizzi e posizioni. Una volta determinato l'indirizzo corretto, puoi chiamare uno dei servizi descritti di seguito per ottenere le informazioni pertinenti. Queste informazioni possono essere utilizzate come input nei sistemi di ottimizzazione del percorso o per fornire un contesto aggiuntivo ai conducenti all'interno della tua applicazione per i conducenti.

  • L'API Geocoding tenta di abbinare un indirizzo inserito a una località con il database di Google Maps e fornisce la latitudine/longitudine.
  • Oltre a fornire una serie di indicatori di convalida, l'API Address Validation fornisce anche la latitudine/longitudine dell'indirizzo inserito. Fornisce inoltre indicatori residenziali e commerciali per la località e una varietà di dati dell'USPS per gli indirizzi statunitensi.
  • L'API Place Details fornisce informazioni sui punti di interesse, inclusi gli orari di apertura delle attività.