Présentation de l'API Address Validation

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

Pourquoi utiliser l'API Address Validation ?

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

L'API Geocoding correspond peut-être mieux à 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 obtenir une comparaison détaillée, consultez l'article Créer une fonctionnalité de validation de lieux à l'aide de Google Maps Platform dans le Centre d'architecture.

Fonctionnalités de l'API Address Validation

Avec l'API Address Validation, vous pouvez 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 qu'ils les corrigent. Voici un exemple de workflow utilisant l'API:

1. Le client saisit une adresse : l'image suivante montre un formulaire simple permettant au client de saisir une adresse, éventuellement lors du processus de paiement.
   

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 fournir les invites suivantes au client :

   • Présentez une adresse recommandée au client pour qu'il confirme:
     

   • Invitez le client à ajouter les informations manquantes:
     

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

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 divise l'adresse en ses composants individuels, puis effectue les vérifications et corrections suivantes:

• Correct : fournit des contrôles de validation au niveau des composants, y compris des sous-sites, le cas échéant.
• Complete (Terminé) : tente de déduire des 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 renvoyées. 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 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 est un moyen utile d'explorer à la fois les valeurs renvoyées par le service ainsi que la réponse de l'API au format JSON.
2	Vérifier la couverture	Consultez les informations sur 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 qui s'affichent.
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 la section 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 la section 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 Gérer les adresses mises à jour.

Bibliothèques clientes disponibles

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

À propos de CASSTM

Le service postal américain (USPS®)¹ gère le système CASSTM (Coding Accuracy Support System) afin d'aider et de certifier les fournisseurs de validation d'adresse. Un service CASS CertifiedTM, tel que l'API Address Validation, est habilité à remplir les informations manquantes dans une adresse, à les standardiser et à les mettre à jour afin de vous fournir l'adresse la plus récente et la plus précise.

CASS n'est pas activé par défaut et n'est compatible qu'avec 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 la section Valider une adresse.

Dans le cadre de notre utilisation de ses services, USPS évalue les demandes 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 pour le client et de communiquer ses coordonnées (nom et adresse), l'adresse d'entrée pertinente et les données d'utilisation agrégées à USPS. En utilisant l'API, vous acceptez les Conditions spécifiques au service.

Étapes suivantes

• Consultez les questions fréquentes en accédant à Questions fréquentes.
• Examiner les zones de couverture: consultez Détails de la couverture par pays et région.
• Traiter un volume élevé d'adresses: consultez Utiliser l'API Address Validation pour traiter un volume élevé d'adresses.