Obiettivo
In questo documento esamineremo come utilizzare l'API Address Validation in Fogli Google per testare il servizio in modo rapido e leggero.
In qualità di non sviluppatore, anche se sei disposto a lavorare con i dati provenienti da Google Maps Platform, come l'API Address Validation, potresti voler trovare un modo per iniziare a utilizzare il servizio senza troppa assistenza 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.
- Confronto: confronta i risultati dell'API Address Validation con i risultati di altri endpoint come l'API Geocoding o l'API Places.
- Test A/B: esegui test A/B sulle varianti dello stesso set di dati per capire cosa
potrebbe fornire risultati più adatti.
Modello di Fogli Google
La soluzione è un foglio Google che viene fornito con funzioni Apps Script personalizzate che eseguono le richieste in sequenza all'API Address Validation.
Puoi eseguire gli indirizzi tramite l'API seguendo i passaggi riportati di seguito (richiede un Account Google e una chiave API):
- Vai al foglio di lavoro di esempio e seleziona File > Crea una copia dal menu (devi accedere al tuo Account Google o crearne uno)
- Abilita l'API
Address Validation
e genera una chiave API dalla console
Cloud.
- Nella scheda del foglio "Chiave API + dashboard", sostituisci la cella B2 con la tua chiave API.
- Copia/incolla gli indirizzi nel modello (in un foglio separato per formattare i dati: concatena numero civico, nome, città, codice postale)
- Seleziona le celle dei fogli e poi seleziona "Address Validation" > "Address Validation API selection" dal menu
- Alla prima esecuzione, verrà visualizzato un messaggio "Autorizzazione richiesta" per
fornire l'accesso ad Apps Script.
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, dopodiché 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 dei Termini di servizio di Google Maps
Platform (Autorizzazioni di memorizzazione nella cache):
- placeId
- Località: valori di latitudine, valori di longitudine
- verdetto
- formattedAddress
- postalAddress
- addressComponent: componentName
- Dati USPS standardizedAddress
Considerazioni
- Prestazioni: procedi in blocchi di massimo 1000 righe alla volta. Lo script può essere interrotto, ad esempio quando viene superata la quota API al secondo. In questo caso, riprendi dalla riga in cui lo script è stato interrotto.
- Puoi accedere al codice da Menu > Estensioni > Apps Script e creare la tua versione dello script in base alle tue esigenze.
- Prezzi dell'API Address Validation.
Conclusione
L'API Address Validation in Fogli Google consente ai non sviluppatori di iniziare a eseguire query sull'API Address Validation e di capire come può essere strategica per la loro attività. Questo documento tenta di dimostrare come chiunque possa iniziare a eseguire query sull'API creando una chiave API e utilizzando il modello di Fogli Google fornito.
Azioni successive
Letture consigliate:
Collaboratori
Google gestisce questo articolo. I seguenti collaboratori lo hanno scritto originariamente.
Autore principale:
Thomas Anglaret | Solutions Engineer