Utiliser l'API Address Validation pour traiter des adresses à volume élevé

Objectif

En tant que développeur, vous travaillez souvent avec des jeux de données contenant des adresses de clients, ne sont peut-être pas de bonne qualité. Vous devez vous assurer que les adresses sont correctes pour de la vérification du numéro client à la livraison, entre autres.

Le module Address Validation de l'API est un produit Google Maps Platform pour valider une adresse. Toutefois, il n'y a traite une adresse à la fois. Dans ce document, nous verrons comment utiliser de l'API High Volume Address Validation dans différents scénarios, des tests d'API à la validation d’adresse ponctuelle et récurrente.

Cas d'utilisation

Nous allons maintenant comprendre les cas d'utilisation dans lesquels la validation d'adresses à grande échelle est utiles.

Tests

Vous souhaitez souvent tester l'API Address Validation en exécutant des milliers de des adresses IP externes. Les adresses se trouvent peut-être dans un fichier de valeurs séparées par des virgules et souhaitez pour valider la qualité des adresses.

Validation unique des adresses

Lors de l'intégration à l'API Address Validation, vous souhaitez valider votre la base de données d'adresses existante par rapport à la base de données des utilisateurs.

Validation récurrente des adresses

Un certain nombre de scénarios nécessitent une validation récurrente des adresses:

  • Vous avez peut-être planifié des jobs pour valider des adresses pour récupérer des détails. au cours de la journée (inscription des clients, détails de la commande, livraison programmations.
  • Vous pouvez recevoir des fichiers de données contenant des adresses de différents services, par exemple, des ventes au marketing. Le nouveau service qui reçoit les souhaitent souvent les valider avant de les utiliser.
  • Vous pouvez collecter les adresses lors d'enquêtes, lors de diverses promotions et plus tard. lors d'une mise à jour dans le système en ligne. Vous souhaitez vérifier que les adresses sont correct lors de leur saisie dans le système.

Détails techniques

Pour les besoins du présent document, nous partons du principe que:

  • Vous appelez l'API Address Validation avec les adresses d'un client base de données (c'est-à-dire une base de données contenant des informations sur le client)
  • Vous pouvez mettre en cache les indicateurs de validité associés à des adresses individuelles dans votre base de données.
  • Les indicateurs de validité sont récupérés à partir de l'API Address Validation lorsqu'une chaque client se connecte.

Cache pour une utilisation en production

Lorsque vous utilisez l'API Address Validation, vous souhaitez souvent mettre en cache une partie du de l'appel d'API. Bien que nos Conditions d'utilisation Limite du service les données pouvant être mises en cache, toutes les données pouvant être mises en cache à partir de l'API Address Validation doit être mis en cache sur un compte utilisateur. Cela signifie que dans la base de données, le adresse e-mail ou métadonnées d'adresse doivent être mises en cache avec l'adresse e-mail ou un autre identifiant principal.

Pour le cas d'utilisation de la validation d'adresses à grande échelle, la mise en cache des données doit respecter le Spécifique au service de l'API Address Validation Conditions d'utilisation, décrits dans la Section 11.3. Grâce à ces informations, vous pourrez : déterminer si l'adresse d'un utilisateur n'est pas valide, auquel cas vous l'utilisateur pour obtenir une adresse corrigée lors de sa prochaine interaction avec votre application.

  • Données de AddressComponent objet <ph type="x-smartling-placeholder">
      </ph>
    • confirmationLevel
    • inferred
    • spellCorrected
    • replaced
    • unexpected

Si vous voulez mettre en cache des informations sur l'adresse réelle, ces données ne doivent être mis en cache qu'avec le consentement de l'utilisateur. Cela garantit que l'utilisateur est bien qu'un service particulier stocke son adresse et qu'il accepte que le service de partager leur adresse.

Un exemple de consentement de l'utilisateur serait une interaction directe avec une adresse e-commerce sur une page de paiement. Il est entendu que vous allez mettre en cache traiter l'adresse afin d'expédier un colis.

Avec l'autorisation de l'utilisateur, vous pouvez mettre en cache formattedAddress et d'autres composants clés de la réponse. Toutefois, dans un scénario sans interface graphique, un utilisateur ne peut pas fournir car l'adresse est validée depuis le backend. Par conséquent, vous pouvez mettre en cache des informations très limitées dans ce scénario sans interface graphique.

Comprendre la réponse

Si la réponse de l'API Address Validation contient les repères suivants, vous pouvez être sûr que l'adresse d'entrée est de qualité livrable:

  • Repère addressComplete dans le verdict est true,
  • validationGranularity dans le verdict objet est PREMISE ou SUB_PREMISE
  • Aucun élément AddressComponent sont marqués comme: <ph type="x-smartling-placeholder">
      </ph>
    • Inferred(Remarque: inferred=truepeut se produire addressComplete=true)
    • spellCorrected
    • replaced
    • unexpected et
  • confirmationLevel: Le niveau de confirmation AddressComponent est défini surCONFIRMEDou surUNCONFIRMED_BUT_PLAUSIBLE

Si la réponse de l'API ne contient pas les marqueurs ci-dessus, l'adresse d'entrée était probablement de mauvaise qualité, et vous pouvez mettre en cache les indicateurs dans votre base de données pour refléter ça. Les indicateurs mis en cache indiquent que l'adresse dans son ensemble est de mauvaise qualité, alors que Des indicateurs plus détaillés, comme "Correcteur orthographique", indiquent le type spécifique résoudre un problème de qualité. Lors de la prochaine interaction d'un client avec une adresse signalée comme mauvaise qualité, vous pouvez appeler l'API Address Validation avec l'API adresse e-mail. L'API Address Validation renvoie l'adresse corrigée que vous avez peut s'afficher à l'aide d'une invite d'interface utilisateur. Une fois que le client a accepté l'adresse formatée vous pouvez mettre en cache les éléments suivants à partir de la réponse:

  • formattedAddress
  • postalAddress
  • addressComponent componentNames ou
  • UspsData standardizedAddress

Implémenter une validation d'adresse sans adresse IP de cluster

Sur la base de la discussion ci-dessus:

  • Il est souvent nécessaire de mettre en cache une partie de la réponse provenant du champ l'API de validation pour des raisons professionnelles.
  • Toutefois, les Conditions d'utilisation Service dans Google Maps Platform limite les données pouvant être mises en cache.

Dans la section suivante, nous verrons un processus en deux étapes pour aux conditions d'utilisation et mettre en œuvre la validation d'un grand nombre d'adresses.

Étape 1 :

Dans la première étape, nous verrons comment implémenter un grand nombre d'adresses. de validation à partir d'un pipeline de données existant. Ce processus vous permettra stocker des champs spécifiques de la réponse de l'API Address Validation dans un de manière conforme aux exigences du service.

Diagramme A:Le schéma suivant montre comment améliorer un pipeline de données avec une logique de validation d'adresses volumineux.

alt_text

Conformément aux conditions d'utilisation, vous pouvez mettre en cache les données suivantes addressComponent:

  • confirmationLevel
  • inferred
  • spellCorrected
  • replaced
  • unexpected

Lors de cette étape de l'implémentation, nous mettrons donc en cache les éléments mentionnés ci-dessus. et le User-ID.

Pour en savoir plus, consultez les détails sur les données réelles structure.

Étape 2 :

À l'étape 1, nous avons recueilli des commentaires indiquant que certaines adresses de l'ensemble de données d'entrée ne pas être de haute qualité. À l'étape suivante, nous utiliserons ces adresses signalées et les présenter à l'utilisateur afin d'obtenir son consentement pour corriger les adresse e-mail.

Diagramme B: ce diagramme montre comment une intégration de bout en bout de l'utilisateur Le flux de consentement peut se présenter comme suit:

alt_text

  1. Lorsque l'utilisateur se connecte, vérifiez d'abord si vous avez mis en cache des indicateurs de validation. dans votre système.
  2. S'il y a des indicateurs, vous devez présenter à l'utilisateur une UI pour corriger et modifier son adresse.
  3. Vous pouvez appeler à nouveau l'API Address Validation avec la version mise à jour ou mise en cache et présenter l'adresse corrigée à l'utilisateur pour qu'il la confirme.
  4. Si l'adresse est de bonne qualité, l'API Address Validation renvoie une formattedAddress
  5. Vous pouvez présenter cette adresse à l'utilisateur si des corrections ont été apportées ou accepter silencieusement s'il n'y a pas de corrections.
  6. Une fois que l'utilisateur a accepté, vous pouvez mettre en cache formattedAddress dans la base de données.

Conclusion

La validation d'adresses à grande échelle est un cas d'utilisation courant que vous êtes susceptible de rencontrer dans de nombreuses applications. Ce document vise à illustrer certains scénarios modèle de conception sur la mise en œuvre d'une telle solution conformément à Google Maps. Conditions d'utilisation de la plate-forme.

Nous avons également rédigé une implémentation de référence pour l'API High Volume Address. Validation en tant que bibliothèque Open Source sur GitHub. Consultez-le pour commencer grâce à l'API High Volume Address Validation. Consultez également l'article sur des modèles de conception pour l'utilisation de la bibliothèque dans différents scénarios.

Étapes suivantes

Téléchargez l'application Améliorez les processus de paiement, de livraison et d'exploitation grâce à des adresses fiables Livre blanc et consultez le module Améliorer les processus de paiement, de livraison et des opérations avec Validation .

Documentation complémentaire suggérée:

Contributeurs

Google tient à jour cet article. Ce message a été initialement rédigé par les contributeurs suivants.
Principaux auteurs:

Henrik Valve | Ingénieur solutions
Thomas Anglaret | Solutions Ingénieur
Sarthak Ganguly | Solutions Ingénieur