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, il faut identifier les adresses incorrectes et mieux connaître leurs caractéristiques.
L'API Geocoding peut être mieux adaptée à 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 des fonctionnalités de validation des positions à 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 correspond à un lieu réel. Si l'adresse ne fait pas référence à un lieu réel, l'API peut identifier des composants potentiellement incorrects que vous pouvez présenter à vos clients pour qu'ils les corrigent. 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 dans le cadre d'un processus de paiement.
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 des résultats renvoyés par l'API, vous pouvez fournir les invites suivantes au client :
Présentez une adresse recommandée pour que le client 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 d'adresse accepte une requête POST dont l'adresse se présente sous la forme d'un corps JSON. Il sépare l'adresse en plusieurs composants, puis effectue les vérifications et corrections suivantes:
- Correct : fournit des contrôles de validation au niveau du composant, y compris des contrôles secondaires, le cas échéant.
- Complete (Terminé) : tente de déterminer les composants d'adresse manquants ou incorrects.
- Format correct : 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 Valider une adresse. |
Adresse complète et validée (si possible). État de validation de chaque composant de l'adresse. Si possible pour une adresse:
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, corrects et incorrects. La démonstration est un moyen utile 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 dans lesquels l'API Address Validation est disponible. |
| 3 | Configuration | Commencez par Configurer votre projet Google Cloud et suivez les instructions qui suivent. |
| 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 au 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 étant utilisée de différentes manières. Consultez la section Comprendre une réponse de base. |
| 6 | Améliorer la précision de la validation | Vous pouvez nous aider à 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 page Bibliothèques clientes.
À propos de CASSTM
Le service postal des États-Unis (USPS®)1 gère le système CASSTM (Coding Accuracy Support System) afin d'aider et de certifier les fournisseurs de validation d'adresse. La capacité d'un service CASS CertifiedTM, tel que l'API Address Validation, à 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 possible a été confirmée.
CASS n'est pas activé par défaut et n'est pris en charge que dans 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 notre utilisation des services USPS, USPS évalue les requêtes pour des adresses créées artificiellement. Si USPS identifie qu'une adresse d'entrée a été créée artificiellement, Google est tenu d'arrêter de valider les adresses pour le client et de communiquer à USPS les coordonnées du client (nom et adresse), l'adresse de saisie pertinente ainsi que les données d'utilisation agrégées. En utilisant l'API, vous acceptez les Conditions spécifiques au service.
Étapes suivantes
- Consulter les questions fréquentes: accédez aux questions fréquentes
- Pour consulter 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 son autorisation: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩