API Address Validation in Fogli Google

Obiettivo

In questo documento, esamineremo come utilizzare l'API di convalida degli indirizzi in Fogli Google per testare il servizio in modo rapido e semplice.

Se non sei uno sviluppatore, ma vuoi utilizzare i dati provenienti da Google Maps Platform, ad esempio l'API Address Validation, potresti voler trovare un modo per iniziare a utilizzare il servizio senza troppo aiuto da parte dei team tecnici.

Casi d'uso

Ora vediamo i casi d'uso in cui l'API Address Validation in Fogli Google è utile:

• Prova: in qualità di azienda, potresti voler testare rapidamente le funzionalità dell'API Address Validation utilizzando i tuoi indirizzi.
• Confronta: confronta i risultati dell'API Address Validation con quelli di altri endpoint come l'API Geocoding o l'API Places.
• Test A/B: esegui test A/B delle varianti dello stesso set di dati per capire cosa potrebbe fornire risultati più adatti.
  

Modello di Fogli Google

La soluzione è un foglio Google fornito con funzioni Apps Script personalizzate che eseguono richieste in sequenza all'API di convalida dell'indirizzo.

Suggerimento: questo esempio è solo per indicazioni sull'integrazione. È necessario garantire la qualità prima di utilizzare le applicazioni. L'assistenza è disponibile per i prodotti come l'API Address Validation utilizzata in questo esempio.

Puoi eseguire gli indirizzi tramite l'API seguendo i passaggi riportati di seguito (sono necessari un Account Google e una chiave API):

1. Vai al Foglio di lavoro di esempio e, dal menu, seleziona File > Crea una copia
   (devi accedere al tuo Account Google o crearne uno)
   
2. Abilita l'API Address Validation e genera una chiave API dalla console Cloud.
   
3. Nella scheda Fogli "Chiave API + Dashboard", sostituisci la cella B2 con la tua chiave API.
   
4. Copia e incolla gli indirizzi nel modello (in un foglio separato per formattare i dati: concatena il numero civico, il nome, la città, il codice postale)
   
5. Seleziona le celle dei fogli e poi seleziona dal menu "Convalida indirizzo" > "Selezione API di convalida indirizzo"
   
6. Alla prima esecuzione, verrà visualizzato il messaggio "Autorizzazione richiesta" per fornire l'accesso ad Apps Script.
   

Attenzione: metti al sicuro la tua chiave API limitando il suo utilizzo solo all'API di convalida degli indirizzi. Per evitare utilizzi imprevisti, assicurati di condividere il foglio solo con parti attendibili ed elimina la chiave nella console al termine dell'analisi.

Suggerimento: per rispettare i Termini di Google Maps Platform, assicurati di eliminare il foglio di lavoro dopo 30 giorni, poiché Fogli Google ha una cronologia integrata.

Termini di Google Maps Platform

La Soluzione viene fornita a scopo di test su un insieme limitato di indirizzi: Periodo di memorizzazione nella cache consentito: 30 giorni di calendario consecutivi, al termine dei quali il Cliente deve (1) eliminare i Contenuti di Google Maps memorizzati nella cache o (2) sostituirli con i dati dell'utente finale forniti tramite la conferma o la correzione dell'utente finale. Fai riferimento alla Tabella 11.3.1 (Autorizzazioni per la memorizzazione nella cache) dei Termini di servizio di Google Maps Platform:

• placeId
  
• Posizione: valori di latitudine, valori di longitudine
  
• verdict
  
• formattedAddress
  
• postalAddress
  
• addressComponent: componenteName
  
• Dati USPS standardizedAddress
  

Considerazioni

• Prestazioni: procedi in blocchi di massimo 1000 righe alla volta. Lo script può eventualmente interrompersi, ad esempio quando si supera la quota API al secondo, e riprendere dalla riga in cui si è interrotto.
• Puoi accedere al codice da Menu > Estensioni > Apps Script e creare la tua versione dello script in base alle tue esigenze
• Prezzi per l'API Address Validation.

Conclusione

L'API di convalida degli indirizzi in Fogli Google consente ai non sviluppatori di iniziare a eseguire query sull'API di convalida degli indirizzi e di capire in che modo può essere strategica per la loro attività. Questo documento cerca di dimostrare come chiunque può iniziare a eseguire query sull'API creando una chiave API e utilizzando il modello di Fogli Google fornito.

Azioni successive

Letture consigliate:

• Convalida dell'indirizzo per il pagamento e-commerce
• Raccolta di validazione degli indirizzi ad alto volume

Collaboratori

Google gestisce questo articolo. È stato originariamente scritto dai seguenti collaboratori.
Autore principale:

Thomas Anglaret | Solutions Engineer\