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 devez intercepter les adresses incorrectes et mieux connaître les caractéristiques d'adresse.
Si vous n'avez pas besoin de valider les composants d'adresse individuels pour votre requête, l'API Geocoding peut être la meilleure solution à vos besoins. L'API Geocoding convertit les adresses en coordonnées de latitude/longitude, tandis que l'API Address Validation valide l'exactitude des adresses. Pour en savoir plus, consultez la section Fonctionnement de l'API Address Validation ci-dessous et la présentation de l'API Geocoding.
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:
Le client saisit une adresse : l'image suivante montre un formulaire simple permettant au client de saisir une adresse, éventuellement lors du processus de règlement.
L'application envoie l'adresse à l'API : l'application transmet cette adresse en tant qu'entrée à l'API Address Validation.
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 où des informations sont manquantes.
Le client corrige ou confirme l'adresse recommandée : en fonction de ce que l'API renvoie, vous pouvez lui fournir les invites suivantes :
Présentez au client une adresse recommandée pour confirmer:
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 sépare l'adresse en ses composants individuels, puis effectue les vérifications et corrections suivantes:
- Correct : permet de procéder à des vérifications de validation au niveau des composants, y compris sur les sous-sites, le cas échéant.
- Terminé : tente de déduire les composants d'adresse manquants ou incorrects.
- Bonne mise en forme : 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. Lorsqu'une adresse est disponible:
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. La démonstration constitue 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 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 relations publiques 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 d'entre elles étant 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 d'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
Le service postal américain (USPS®)1 gère le système CASSTM (Coding Accuracy Support System) afin d'aider et de certifier les fournisseurs de validation d'adresse. Il a été confirmé qu'un service CASS CertifiedTM, tel que l'API Address Validation, peut 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.
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 l'utilisation de ses services, USPS évalue les demandes d'adresses créées artificiellement. Si USPS identifie une adresse d'entrée comme étant créée artificiellement, Google est tenu de cesser de valider les adresses pour le client et de communiquer les coordonnées du client (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
- Pour consulter les questions fréquentes, accédez aux questions fréquentes.
- Pour examiner les zones de couverture: consultez Détails de la couverture par pays et région
- Traiter un grand nombre d'adresses: consultez Utiliser l'API Address Validation pour traiter un volume élevé d'adresses.
-
Google Maps Platform est un licencié non exclusif du service postal des États-Unis®. La ou les marques suivantes appartiennent au service postal des États-Unis et sont utilisées avec l'autorisation des services suivants: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩