Créer une fonctionnalité de validation d'emplacement à l'aide de Google Maps Platform

Objectif

Vous avez souvent besoin de valider la position d'un lieu. Plusieurs services de Google Maps Platform peuvent vous aider dans ce cas d'utilisation. Ce document vous aide à choisir entre les deux principaux services de validation de localisation : l'API Address Validation et l'API Geocoding.

L'API Address Validation est une offre Google Maps Platform qui aide les clients à valider l'exactitude d'une adresse.

Le geocoding avec l'API Geocoding consiste à convertir des adresses en coordonnées géographiques, que vous pouvez utiliser pour placer des repères ou positionner la carte.

Pour obtenir un aperçu des différences entre l'API Address Validation et l'API Geocoding, cliquez ici.

Essayer maintenant : accédez à la console Google Cloud et activez l'API Address Validation et l'API Places.

Quand choisir entre l'API Address Validation et l'API Geocoding

Remarques concernant l'organigramme ci-dessus :

• Le cas d'utilisation de l'interaction utilisateur fait référence à une situation où un utilisateur est présent pour interagir avec les résultats.
• Places Autocomplete est une API JavaScript qui peut donc être intégrée aux interfaces utilisateur.
• Vous avez peut-être déjà identifié des problèmes de qualité des données dans vos adresses existantes. Même si vous ne souhaitez obtenir que des géocodes, il est conseillé d'exécuter ces emplacements via l'API Address Validation pour corriger les ensembles de données.

Dans de nombreuses situations, vous pouvez choisir d'utiliser un produit plutôt qu'un autre en fonction de l'arbre de décision ci-dessus. Toutefois, dans d'autres situations, vous devrez peut-être utiliser les deux produits pour atteindre vos objectifs.

Vous pouvez choisir d'utiliser l'API Address Validation plutôt que l'API Geocoding dans les cas suivants :

• Il existe un risque élevé de données douteuses ou d'impact négatif en aval si l'adresse est incorrecte. En effet, l'API Address Validation fournit plus d'informations sur les raisons pour lesquelles une entrée n'a pas obtenu de résultat de haute précision.
• Vous devez corriger les saisies des utilisateurs (par exemple, les fautes d'orthographe ou les champs manquants), ce qui augmente la probabilité d'obtenir un résultat précis.
• Votre région cible renvoie plus de métadonnées de l'API Address Validation que l'API Geocoding, comme la classification du type de bâtiment (résidentiel ou commercial).

Vous pouvez choisir d'utiliser l'API Geocoding plutôt que l'API Address Validation dans les cas suivants :

• Votre objectif principal est de récupérer la position d'une adresse. La précision des adresses individuelles n'est pas forcément essentielle.
  • Par exemple, pour générer une carte de densité à partir d'un grand ensemble de données.
• Vous avez besoin d'une solution mondiale, mais l'API Address Validation n'est pas disponible dans toutes les régions cibles.

Voici quelques exemples qui illustrent les fonctionnalités de l'API Address Validation par rapport à l'API Geocoding.

Exemple d'adresse non valide

1 Fake St, Mountain View, CA 94043, États-Unis

L'API Address Validation décompose cette entrée en différents composants d'adresse (rue, ville, État, etc.). Il peut également fournir des commentaires précis sur la raison pour laquelle l'adresse n'est pas valide, jusqu'au niveau PREMISE.

Fake St n'existe pas à Mountain View, en Californie, et l'API Address Validation le reflète dans les détails au niveau des composants renvoyés :

{
  "componentName": {
    "text": "Fake St",
    "languageCode": "en"
   },
   "componentType": "route",
   "confirmationLevel":"UNCONFIRMED_BUT_PLAUSIBLE"
 }

La propriété importante à inspecter dans ce cas est confirmationLevel. En renvoyant UNCONFIRMED_BUT_PLAUSIBLE pour la rue fictive, l'API a déterminé qu'une rue pouvait porter ce nom, mais qu'il n'était pas possible de l'associer aux données d'adresse correspondantes.

En utilisant le résultat de l'API comme commentaire, on peut en déduire que le problème vient du composant "rue" de cette entrée ("Fake St").

En utilisant la même adresse avec l'API Geocoding, il est possible de trouver une correspondance pour "Californie", comme vous pouvez le voir dans la capture d'écran de l'outil de géocodage que vous pouvez essayer ici :

Toutefois, le résultat est un géocode de l'ensemble de l'État, avec un minimum de commentaires sur les composants potentiellement défectueux dans l'entrée.

Exemple de faute d'orthographe

76 Buckingamm Palace Road, Londn, SW1W 9TQ, GB

L'adresse ci-dessus contient deux fautes d'orthographe, l'une dans le nom de la rue et l'autre dans la localité.

Les API Address Validation et Geocoding peuvent corriger ces erreurs et obtenir le résultat "76 Buckingham Palace Road, Londres, SW1W 9TQ". Toutefois, l'API Address Validation peut fournir plus d'informations sur le processus.

Examinez l'un des composants d'adresse mal orthographiés dans l'entrée :

{
  "componentName": {
    "text": "Buckingham Palace Road",
    "languageCode": "en"
        },
        "componentType": "route",
        "confirmationLevel": "CONFIRMED",
        "spellCorrected": true
     }
}

L'API Address Validation renvoie un indicateur pour indiquer qu'une correction a été apportée au champ. La logique métier peut être implémentée par rapport à ce signalement pour vérifier la correction auprès du fournisseur de données, comme un client lors du règlement d'un achat en ligne.

Exemple de données manquantes et de faute d'orthographe

Bollschestraße 86, 12587, DE

Dans l'adresse ci-dessus, le nom de la rue comporte une faute d'orthographe et la ville (localité) de Berlin est manquante.

L'API Address Validation peut corriger ces deux erreurs et renvoie un géocode de niveau PREMISE et une adresse validée au niveau PREMISE :

Bölschestraße 86, 12587 Berlin, DE

Dans ce cas, l'API Geocoding ne parvient pas à surmonter les erreurs de saisie et renvoie un résultat ZERO_RESULTS.

Exemple de métadonnées d'adresse supplémentaires

111 8th Avenue Ste 123, New York, NY 10011-5201, États-Unis

Cette adresse est correcte, à l'exception du numéro d'unité (Ste 123), qui n'existe pas dans le bâtiment.

L'API Address Validation peut valider l'adresse PREMISE (111 8th Ave) et fournir des métadonnées sur la propriété, y compris le fait qu'il s'agit d'un établissement commercial.

premises:

"business": true

De plus, la valeur dpvConfirmation renvoyée dans le cadre de uspsData dans la réponse est S :

"dpvConfirmation": "S"

Une valeur dpvConfirmation de S indique que l'adresse est validée au niveau PREMISE, mais que le numéro d'appartement fourni dans l'entrée n'est pas associé à cette adresse.

L'API Geocoding ne peut pas fournir ces informations.

Comprendre la réponse de l'API Geocoding

Présentation

Si vous utilisez l'API Geocoding, le résultat du géocodage contient différents indices dans la réponse qui peuvent être utilisés pour comprendre les détails de l'adresse fournie.

L'API Geocoding fonctionne en résolvant les composants d'adresse dans une hiérarchie.

Par **exemple, 123 Example Street, Chicago, 60007, USA est résolu dans l'ordre suivant :

/ Example Street/ Chicago/ 60007/ USA seront évaluées dans cet ordre. Dans ce cas, la première correspondance est Chicago et, plus précisément, le code postal 60007. Par conséquent, il renvoie l'ID de lieu suivant pour ce code postal :

ChIJwRKzf8ixD4gRHiXqucwr_HQ

L'API Geocode contient les informations suivantes dans la réponse :

        "partial_match": true,
           "place_id": "ChIJwRKzf8ixD4gRHiXqucwr_HQ",
           "types": [
               "postal_code"
           ]

L'API Geocoding peut confirmer le type de lieu auquel appartient cette adresse. Pour consulter la liste des types d'adresse renvoyés par l'API Geocoding, cliquez ici.

Si aucun des composants de l'entrée n'est résolu, l'API renvoie :

{
   "results": [],
   "status": "ZERO_RESULTS"
}

Si vous effectuez une requête avec uniquement une adresse sans numéro de maison, vous obtiendrez un résultat au format suivant :

"types": [
  "route"
]

Cela signifie que l'API Geocoding n'a pas pu trouver ni faire correspondre un numéro de rue.

Remarque : Pour savoir si une adresse existe, vérifiez si l'un des paramètres (comme types ou partial_match, results, status)) est défini dans la réponse de l'API Geocoding. Cela augmentera progressivement le niveau de confiance qu'une adresse puisse exister, mais ne la rendra pas précise à 100 %. C'est pourquoi nous avons besoin de l'API Address Validation.

Vous pouvez utiliser les techniques ci-dessus pour améliorer la fiabilité de la précision des adresses à partir d'une réponse de l'API Geocoding seule. Toutefois, contrairement à l'API Address Validation, l'API Geocoding ne fournit pas de commentaires précis pour déterminer l'exactitude des résultats.

Type d'emplacement

Pour bien comprendre cette section, vous devez connaître les différents types de lieux qui peuvent être renvoyés par une réponse de l'API Geocoding :

• ROOFTOP indique que le résultat renvoyé est un geocode précis pour lequel nous disposons d'informations de localisation précises au niveau de l'adresse postale.
• RANGE_INTERPOLATED indique que le résultat renvoyé reflète une approximation (généralement sur une route) interpolée entre deux points précis (des intersections, par exemple). Les résultats interpolés sont généralement renvoyés lorsque le géocodage rooftop est indisponible pour une adresse postale.
• GEOMETRIC_CENTER indique que le résultat renvoyé est le centre géométrique d'un résultat, comme une polyligne (par exemple, une rue) ou un polygone (une région).
• APPROXIMATE indique que le résultat renvoyé ne correspond à aucune des catégories ci-dessus.

Si l'API Geocoding renvoie un location_type de ROOFTOP ou RANGE_INTERPOLATED, cela ne signifie pas nécessairement que l'adresse existe. De même, si l'API Geocoding renvoie le résultat avec le flag partial_match défini sur true, il peut quand même s'agir du bon résultat pour vous.

Ce type de faux correspondance est un problème très difficile à résoudre avec l'API Geocoding. Au minimum, vous pouvez envisager d'implémenter une validation de post-traitement de base sur le pays et la localité de la requête / réponse. Mieux encore, comparez les adresses postales réelles pour vérifier qu'elles ne contiennent pas d'erreur de syntaxe et/ou qu'elles sont bien complètes.

Remarque : Si vous décidez d'utiliser l'API Geocoding, nous vous recommandons de vérifier régulièrement la qualité des données entre la requête initiale et la réponse de l'API Geocoding.

Correspondance partielle et fausse correspondance

Si une adresse ne correspond que partiellement (c'est-à-dire que l'API Geocoding n'a pas pu l'identifier exactement), la réponse contient les éléments suivants :

"partial_match": true,
"types": [
           "locality",
           "political"
         ]

Il est encore plus important que les types d'emplacement ci-dessus de tenir compte du moment où partial_match = true est dans la réponse. partial_match indique que l'API Geocoding n'a pas renvoyé de correspondance exacte pour la requête d'origine, bien qu'elle ait pu trouver une partie de l'adresse demandée.

Nous vous recommandons d'examiner la requête d'origine pour vérifier que l'adresse est bien complète. Les correspondances partielles sont souvent renvoyées lorsque l'adresse postale n'existe pas dans la localité indiquée dans la requête. Les correspondances partielles peuvent aussi être renvoyées lorsqu'une requête correspond à plusieurs lieux au sein de la même localité.

Par exemple, "21 Henr St, Bristol, UK" renvoie une correspondance partielle pour Henry Street et Henrietta Street. Notez que si une requête comprend un composant d'adresse mal saisi, l'API Geocoding peut suggérer une autre adresse. Les suggestions déclenchées de cette façon ne sont pas signalées comme des correspondances partielles.

Adresses synthétiques

L'API Geocoding peut renvoyer des emplacements pour des adresses "synthétiques" qui n'existent pas en tant qu'emplacements précis dans la base de données de Google.

Dans ce cas, l'objet de réponse contient souvent un long ID de lieu et la propriété suivante : geometry.location_type=APPROXIMATE.

Si vous rencontrez ces indicateurs dans la réponse, veuillez marquer l'adresse saisie comme non valide et essayer de la valider à nouveau par un autre moyen.

Remarque : Voici un autre exemple où l'API Address Validation vous permet d'obtenir un retour direct si une adresse n'existe pas.

Comprendre la réponse de l'API Address Validation

Il existe déjà une excellente documentation sur la façon de comprendre les réponses de l'API Address Validation. Nous n'entrerons donc pas dans les détails ici.

• Pour en savoir plus sur l'objet de réponse, cliquez ici.
• Cliquez ici pour accéder à une démo illustrant les différents composants de la réponse.
• Le document sur la validation des adresses pour le règlement décrit en détail comment faire la différence entre les adresses valides et celles qui ne le sont pas.

Bonnes pratiques

Spécifier une zone géographique

Lorsque vous appelez les API Address Validation ou Geocoding, il est recommandé de limiter la zone géographique dans laquelle rechercher l'adresse. Les deux API implémentent cela de deux manières différentes :

• API Geocoding : biais régional

  Si vous savez que les codes géographiques se trouveront dans un certain pays, vous obtiendrez de bien meilleurs résultats en utilisant la pondération géographique. Par exemple, si vous effectuez du géocodage au Canada, nous vous recommandons d'ajouter &region=ca à vos requêtes pour favoriser le Canada. Veuillez noter que la pondération régionale ne fait que privilégier les résultats dans cette région. Vous pouvez toujours obtenir des résultats en dehors de la région.

• API Address Validation – Code de région

  De même, l'API Address Validation produit des résultats plus précis si un code ISO2 est transmis dans la requête à l'aide du champ regionCode.

Stocker les ID de lieu

Pour stocker des informations Google Maps Platform sur le lieu pour les requêtes futures, vous pouvez stocker l'ID de lieu indéfiniment dans votre base de données en tant qu'attribut du lieu. Vous n'avez besoin d'exécuter la requête Find Place qu'une seule fois par placeID. Vous pouvez également rechercher l'ID de lieu chaque fois qu'un utilisateur demande des détails sur une transaction.

Pour toujours fournir des informations à jour, actualisez les ID de lieu tous les 12 mois à l'aide d'une requête Place Details avec le paramètre place_id.

Remarque : Veillez également à consulter le guide des bonnes pratiques pour le géocodage.

Conclusion

Ce document décrit les principales différences entre les API Address Validation et Geocoding. En résumé, pensez à utiliser l'API Address Validation dans les cas suivants :

• Vous devez fournir une adresse postale exacte, en particulier pour que les e-mails puissent être distribués.
• Les données d'entrée sont connues pour être de mauvaise qualité. L'API Address Validation est plus tolérante aux erreurs de saisie, met en évidence les composants d'adresse non vérifiables et corrige les données saisies.
• Des informations supplémentaires sont requises pour une adresse, comme le type (résidentielle ou commerciale, disponible dans certaines régions).

Étapes suivantes

Téléchargez le livre blanc sur l'amélioration des processus de paiement, de livraison et opérationnels grâce à des adresses fiables et regardez le webinaire sur l'amélioration des processus de paiement, de livraison et opérationnels grâce à la validation d'adresse .

Lectures complémentaires suggérées :

• Validation de l'adresse pour le règlement sur les sites d'e-commerce
• Documentation Place Autocomplete
• Documentation de l'API Address Validation
• Rapports Google Maps Platform

Contributeurs

Google gère cet article. Les contributeurs suivants en sont les auteurs originaux.

Auteurs principaux :

Henrik Valve | Ingénieur de solutions

Thomas Anglaret | Ingénieur de solutions

Sarthak Ganguly | Ingénieur solutions