Présentation de l'API Address Validation

Présentation de Address Validation

L'API Address Validation est un service qui accepte une adresse. Il identifie et valide les composants de l'adresse. De plus, il standardise l'adresse pour l'envoi de courriers et trouve les coordonnées de latitude/longitude les plus connues. Pour les adresses aux États-Unis et à Porto Rico, vous pouvez éventuellement activer le système CASSTM (Coding Accuracy Support System).

Pourquoi utiliser l'API Address Validation ?

Avec l'API Address Validation, vous pouvez améliorer la prévisibilité de la livraison et réduire le nombre d'échecs de livraison, améliorant ainsi l'expérience client. Pour ce faire, vous devez intercepter les adresses incorrectes et mieux connaître les caractéristiques de l'adresse.

L'API Geocoding peut correspondre à vos besoins si vous n'avez pas besoin de valider les composants d'adresse individuels. L'API Geocoding convertit les adresses en coordonnées de latitude/longitude, tandis que l'API Address Validation valide l'exactitude des adresses. Pour une comparaison détaillée, consultez la section Créer une fonctionnalité de validation de position à l'aide de Google Maps Platform dans le Centre d'architecture.

Ce que vous pouvez faire avec l'API Address Validation

L'API Address Validation vous permet de déterminer si une adresse fait référence à un lieu réel. Si l'adresse ne fait pas référence à un lieu réel, l'API peut identifier les composants potentiellement incorrects que vous pouvez présenter à vos clients pour les corriger. Voici un exemple de workflow utilisant l'API:

  1. Le client saisit une adresse : l'image suivante montre un formulaire simple permettant aux clients de saisir une adresse, par exemple lors du processus de paiement.
    Adresse saisie par le client.

  2. L'application envoie l'adresse à l'API : l'application transmet cette adresse en tant qu'entrée à l'API Address Validation.

  3. L'API valide et standardise l'adresse : dans sa réponse, l'API Address Validation renvoie l'adresse complète déterminée par l'API, ou indique les informations manquantes.

  4. Le client corrige ou confirme l'adresse recommandée : en fonction de ce que l'API renvoie, vous pouvez lui fournir les invites suivantes :

    • Montrez au client une adresse recommandée pour qu'il confirme:
      Demandez au client de confirmer l'adresse, telle qu'elle est déterminée par l'API.

    • Invitez le client à ajouter les informations manquantes:
      Invitez le client à saisir les informations d'adresse manquantes.

    • Invitez l'utilisateur à corriger l'adresse si l'API ne parvient pas à valider l'adresse saisie en raison d'informations manquantes ou incorrectes:
      Invitez le client à corriger les informations d'adresse.

Fonctionnement de l'API Address Validation

La validation de l'adresse accepte une requête POST avec l'adresse sous la forme d'un corps JSON. Il sépare l'adresse en ses composants individuels, puis effectue les vérifications et corrections suivantes:

  • Correct : fournit des vérifications de validation au niveau des composants, y compris des sous-sites, le cas échéant.
  • Terminé : tente de déduire les composants d'adresse manquants ou incorrects.
  • Bien formaté : nettoie et standardise le format des composants d'adresse.

Essayez la démonstration pour voir l'API Address Validation en action.

Ressources

Le tableau suivant récapitule les ressources disponibles via l'API Address Validation, ainsi que les données qu'elle renvoie. Pour en savoir plus, consultez la documentation de référence de l'API Address Validation.

Ressources de données Données renvoyées

Composants d'adresse au format JSON.

Consultez la section Valider une adresse.

Adresse complète et validée (si possible).

État de validation de chaque composant d'adresse.

Le cas échéant, pour une adresse:

  • Géocoder
  • Précision de l'adresse
  • Données des services postaux, lorsqu'elles sont disponibles.

Consultez la section Comprendre la réponse de validation.

Utiliser l'API Address Validation

1 Essayer la version de démonstration Explorez la démonstration avec différents formulaires d'adresse, qu'ils soient corrects ou incorrects. Cette démonstration permet d'explorer à la fois les valeurs renvoyées par le service et la réponse de l'API au format JSON.
2 Vérifier la couverture Consultez les détails de la couverture pour connaître les pays et régions compatibles avec l'API Address Validation.
3 Configuration Commencez par Configurer votre projet Google Cloud, puis suivez les instructions ci-dessous.
4 Demander la validation d'une adresse Commencez par une adresse simple, puis, pour plus de précision, vous pouvez activer CASS (pour les adresses aux États-Unis et aux PR uniquement). Consultez Demander la validation d'une adresse.
5 Traiter une réponse La réponse de l'API Address Validation fournit deux propriétés, chacune utilisée de manière différente. Consultez Comprendre une réponse de base.
6 Améliorer la précision de la validation Vous pouvez contribuer à améliorer la précision des adresses en envoyant des commentaires sur les réponses de l'API Address Validation. Consultez Envoyer des commentaires sur la validation de l'adresse.

Bibliothèques clientes disponibles

Pour obtenir la liste des bibliothèques clientes disponibles pour l'API Address Validation, consultez la page Bibliothèques clientes.

À propos de CASSTM

L'U.S. Postal Service® (USPS®)1 gère le Coding Accuracy Support System (CASSTM) afin d'assurer la compatibilité et la certification des fournisseurs de validation d'adresse. La capacité d'un service CASS CertifiedTM, tel que l'API Address Validation, à renseigner des informations manquantes dans une adresse, à les standardiser et à les mettre à jour pour vous fournir l'adresse la plus récente et la plus précise a été confirmée.

CASS n'est pas activé par défaut et n'est disponible que pour les régions "US" et "PR". Pour activer CASS, définissez enableUspsCass sur true dans le cadre d'une requête de validation. Pour en savoir plus, consultez Valider une adresse.

Dans le cadre de son utilisation de ses services, USPS évalue les requêtes d'adresses créées artificiellement. Si USPS identifie une adresse d'entrée comme ayant été créée artificiellement, Google est tenu d'arrêter de valider les adresses du client et de signaler ses coordonnées (nom et adresse), l'adresse d'entrée correspondante et les données d'utilisation agrégées à USPS. En utilisant l'API, vous acceptez les Conditions spécifiques au service.

Étapes suivantes


  1. Google Maps Platform est un licencié non exclusif du service Postal Service® des États-Unis. La ou les marques suivantes appartiennent à United States Postal Service® et sont utilisées avec autorisation: United States Postal Service®, CASSTM, CASS CertifiedTM.