Introduction
L'API Address Validation est un service qui accepte une adresse. Elle identifie les composants d'une adresse et les valide. Elle standardise également l'adresse pour la distribution postale et trouve les meilleures coordonnées de latitude/longitude connues. Vous pouvez éventuellement activer le système CASS™ (Coding Accuracy Support System) pour les adresses aux États-Unis et à Porto Rico.Pourquoi utiliser l'API Address Validation ?
L'API Address Validation vous permet d'améliorer la prévisibilité des livraisons et de réduire les échecs de livraison, ce qui améliore l'expérience client. Pour ce faire, vous devez identifier les adresses incorrectes et mieux comprendre leurs caractéristiques.
L'API Geocoding peut mieux répondre à vos besoins si vous n'avez pas besoin de valider les composants individuels des adresses. L'API Geocoding convertit les adresses en coordonnées de latitude et de longitude. L'API Address Validation valide les adresses pour s'assurer qu'elles sont correctes. Pour une comparaison détaillée, consultez Créer une fonctionnalité de validation de localisation à l'aide de Google Maps Platform dans le centre d'architecture.
Fonctionnalités de 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 les 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 de base qui permet à un client de saisir une adresse, éventuellement dans le cadre d'un 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 normalise l'adresse : dans sa réponse, l'API Address Validation renvoie l'adresse complète telle qu'elle a été déterminée par l'API ou indique les informations manquantes.
Le client confirme ou corrige l'adresse : selon ce que renvoie l'API, vous pouvez fournir les invites suivantes au client : A. Confirmez l'adresse recommandée. B. Fournissez les informations manquantes. C. Corrigez l'adresse.
Fonctionnement de l'API Address Validation
La validation d'adresse accepte une requête POST avec l'adresse sous la forme d'un corps JSON. Il sépare l'adresse en différents composants, puis tente les opérations suivantes :
- Corrige : effectue des contrôles de validation au niveau des composants, y compris les sous-lieux, le cas échéant.
- Complète : tente d'inférer les composants d'adresse manquants ou incorrects.
- Formats : nettoie et standardise le format des composants d'adresse.
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 Valider une adresse. |
Adresse complète et validée (si possible). État de validation de chaque composant d'adresse. Si l'option est disponible pour une adresse :
Consultez Comprendre la réponse de validation. |
Utiliser l'API Address Validation
| 1 | Essayer la démo | Découvrez la démo avec différents formulaires d'adresse, corrects et incorrects. La démo permet d'explorer facilement 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 savoir quels pays et régions sont compatibles avec l'API Address Validation. |
| 3 | Configurer | Commencez par Configurer votre projet Google Cloud, puis suivez les instructions. |
| 4 | Demander la validation d'une adresse | Commencez par une adresse de base, puis, pour plus de précision, vous pouvez activer CASS (pour les adresses aux États-Unis et à Porto Rico 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, que vous utilisez chacune de manière différente. Consultez 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 nous 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 Bibliothèques clientes.
À propos de CASS™
Le service postal des États-Unis (USPS®)1 gère le système CASS™ (Coding Accuracy Support System) afin d'aider et de certifier les fournisseurs de validation d'adresse. Un service certifié CASS™, tel que l'API Address Validation, a été confirmé pour sa capacité à compléter les informations manquantes d'une adresse, à la standardiser et à la 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 une demande de validation. Pour en savoir plus, consultez Valider une adresse.
Dans le cadre de notre utilisation des services USPS, USPS évalue les demandes d'adresses créées artificiellement. Si l'USPS identifie une adresse saisie comme ayant été créée artificiellement, Google est tenu de cesser de valider les adresses pour le client et doit communiquer à l'USPS les coordonnées du client (nom et adresse), l'adresse saisie concernée et les données d'utilisation agrégées. En utilisant l'API, vous acceptez les présentes Conditions d'utilisation spécifiques au service.
Étape suivante
- Essayez la démo : accédez à Démo.
- Consultez les zones de couverture : accédez à Informations sur la couverture par pays et par région.
- Envoyez votre première demande de validation : accédez à Envoyer une demande de validation d'adresse.
- Traiter un grand nombre d'adresses : consultez Utiliser l'API Address Validation pour traiter un grand nombre d'adresses.
-
Google Maps Platform est un licencié non exclusif du service postal des États-Unis(United States Postal Service®). La ou les marques suivantes appartiennent au service postal des États-Unis et sont utilisées avec son autorisation : United States Postal Service®, CASS™, CASS Certified™. ↩