Obiettivo
In questo documento vedremo come utilizzare l'API Address Validation in Fogli Google per testare il servizio in modo rapido e semplice.
Se non sei uno sviluppatore, ma vuoi 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.
- Confronta: 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 dotato di funzioni Apps Script personalizzate che eseguiranno 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 dal menu seleziona: File > Crea una copia
(devi accedere al tuo Account Google o crearne uno) - Abilita l'API Address Validation e genera una chiave API dalla console Cloud.
- Nella scheda "API Key + Dashboard" (Chiave API + Dashboard) del foglio, 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 del foglio, quindi seleziona dal menu "Address Validation" > "Address Validation API selection"
- 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, dopo i 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 conferma o correzione dell'Utente finale. Consulta la Tabella 11.3.1 (Autorizzazioni di memorizzazione nella cache) dei Termini di servizio di Google Maps Platform:
- placeId
- Località: valori di latitudine, valori di longitudine
- verdetto
- formattedAddress
- postalAddress
- addressComponent: componentName
- USPS Data standardizedAddress
Considerazioni
- Prestazioni: procedi con blocchi di 1000 righe alla volta, non di più. Lo script può interrompersi, ad esempio quando supera la quota API al secondo, procedi dalla riga in cui lo script si è interrotto.
- Puoi accedere al codice da Menu > Estensioni > Apps Script e creare la tua versione dello script personalizzata in base alle tue esigenze
- Prezzi per l'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 per approfondire:
Collaboratori
Google gestisce questo articolo. È stato scritto originariamente dai seguenti collaboratori.
Autore principale:
Thomas Anglaret | Solutions Engineer\