API Address Validation dans Google Sheets

Objectif

Dans ce document, nous allons voir comment utiliser l'API Address Validation dans Google Sheets afin de tester le service de manière rapide et légère.

En tant que non développeur, tout en étant prêt à travailler avec des données provenant de Google Maps Platform, comme l'API Address Validation, vous souhaiterez peut-être trouver un moyen de vous familiariser avec le service sans trop vous faire aider d'équipes techniques.

Cas d'utilisation

Voyons maintenant les cas d'utilisation où l'API Address Validation dans Google Sheets est utile:

• Essai: en tant qu'entreprise, vous pouvez tester rapidement les fonctionnalités de l'API Address Validation à l'aide de vos propres adresses.
• Comparer: comparez les résultats de l'API Address Validation avec ceux d'autres points de terminaison, tels que l'API Geocoding ou l'API Places.
• Test A/B: testez les variantes du même ensemble de données pour comprendre ce qui pourrait fournir des résultats plus adaptés.
  

Modèle Google Sheets

La solution consiste en un Google Sheets fourni avec des fonctions Apps Script personnalisées qui effectueront des requêtes de manière séquentielle à l'API Address Validation.

Remarque :Cet exemple est destiné à fournir des conseils d'intégration uniquement. Vous devez vous assurer de la qualité avant de l'utiliser dans vos applications. Une assistance est disponible pour les produits tels que l'API Address Validation utilisée dans cet exemple.

Vous pouvez exécuter des adresses à l'aide de l'API en suivant les étapes ci-dessous (nécessite un compte Google et une clé API):

1. Accédez à l'exemple de feuille de calcul, puis dans le menu, sélectionnez Fichier > Créer une copie
   (vous devez vous connecter à votre compte Google ou en créer un).
   
2. Activez l'API Address Validation et générez une clé API depuis Cloud Console.
   
3. Dans l'onglet Sheets "Clé API + Tableau de bord", remplacez la cellule B2 par votre clé API.
   
4. Copiez et collez les adresses dans le modèle (dans une feuille distincte pour mettre en forme les données: concaténez le numéro de rue, le nom, la ville et le code postal).
   
5. Sélectionnez les cellules des feuilles, puis dans le menu, sélectionnez "Address Validation" > "Address Validation API selection" (Validation des adresses > Sélection de l'API de validation des adresses).
   
6. Lors de la première exécution, un message "Autorisation requise" s'affiche pour autoriser l'accès à Apps Script.
   

Attention :Sécurisez votre clé API en limitant son utilisation à l'API Address Validation. Pour éviter toute utilisation inattendue, veillez à ne partager votre feuille qu'avec des tiers de confiance et supprimez votre clé de la console une fois l'analyse terminée.

Conseil :Pour respecter les conditions d'utilisation de Google Maps Platform, veillez à supprimer la feuille de calcul au bout de 30 jours, car Google Sheets dispose d'un historique intégré.

Conditions d'utilisation de la plate-forme Google Maps

La solution est fournie à des fins de test sur un ensemble limité d'adresses : période de mise en cache autorisée: 30 jours calendaires consécutifs, après quoi le Client doit (1) supprimer le contenu Google Maps mis en cache ou (2) le remplacer par les données de l'utilisateur final fournies via la confirmation ou la correction de l'utilisateur final. Consultez le tableau 11.3.1 des conditions d'utilisation de Google Maps Platform (autorisations de mise en cache):

• placeId
  
• Emplacement: latitude et longitude
  
• verdict
  
• formattedAddress
  
• postalAddress
  
• addressComponent: nomComposant
  
• Données USPS standardizedAddress
  

Remarques

• Performances: procédez par blocs de 1 000 lignes maximum à la fois. Le script peut éventuellement s'arrêter, par exemple en cas de dépassement du quota d'API par seconde. Poursuivez à partir de la ligne où le script s'est arrêté.
• Vous pouvez accéder au code depuis Menu > Extensions > Apps Script et créer votre propre version du script adaptée à vos besoins.
• Tarifs pour l'API Address Validation.

Conclusion

L'API Address Validation dans Google Sheets permet aux non-développeurs de commencer à interroger l'API Address Validation et de comprendre en quoi elle peut être stratégique pour leur entreprise. Ce document tente de montrer comment n'importe qui peut commencer à interroger l'API en créant une clé API et en utilisant le modèle Google Sheets fourni.

Étapes suivantes

Autres ressources recommandées:

• Validation des adresses pour le règlement dans l'e-commerce
• Bibliothèque de validation des adresses à fort volume

Contributeurs

Cet article est géré par Google. Les contributeurs suivants l'ont initialement rédigé.
Auteur principal:

Thomas Anglaret | Ingénieur solutions\