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 détecter les mauvaises adresses et mieux connaître les caractéristiques des adresses.
L'API Geocoding peut être plus 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 et de longitude. L'API Address Validation vérifie que les adresses sont correctes. Pour une comparaison détaillée, consultez la section Fonctionnalité de validation de l'emplacement des bâtiments à l'aide de Google Maps Platform dans l'Architecture Center.
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 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 de base permettant au client de saisir une adresse, éventuellement dans le cadre d'un parcours de paiement.
L'application envoie l'adresse à l'API : l'application transmet cette adresse en 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 telle que déterminée par l'API ou indique les informations manquantes.
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 que le client doit confirmer:
Demandez au client d'ajouter les informations manquantes:
Demandez à l'utilisateur de corriger l'adresse si l'API ne parvient pas à la valider en raison d'informations manquantes ou incorrectes:
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 ses différents composants, puis effectue les vérifications et corrections suivantes:
- Correct (Correcte) : fournit des contrôles de validation au niveau des composants, y compris les sous-sites, le cas échéant.
- Complète : tente d'inférer les composants d'adresse manquants ou incorrects.
- Formaté correctement : nettoie et standardise le format des composants de l'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 Valider une adresse. |
Adresse complète et validée (si possible) État de validation de chaque composant de l'adresse. Lorsque l'adresse est disponible:
Consultez Comprendre la réponse de validation. |
Utiliser l'API Address Validation
| 1 | Essayer la démo | Explorez la démonstration avec différents formats d'adresses, corrects et incorrects. La 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 qui suivent. |
| 4 | Demander la validation d'une adresse | Commencez par une adresse de base, puis, pour plus de précision, vous pouvez activer le système 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 différentes manières. 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 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 CASS™
Le service postal des États-Unis (United States Postal Service® ou 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é validé pour sa capacité à renseigner les informations manquantes d'une adresse, à la normaliser et à la mettre à jour afin de vous fournir l'adresse la plus récente et la plus précise.
Le CASS n'est pas activé par défaut et n'est compatible qu'avec les régions "États-Unis" et "Porto Rico". 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 des services de l'USPS, l'USPS évalue les demandes d'adresses créées artificiellement. Si USPS identifie une adresse saisie comme étant créée artificiellement, Google doit cesser de valider les adresses pour le client et doit signaler à 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 Conditions spécifiques au service.
Étape suivante
- Consulter les questions fréquentes: accédez aux questions fréquentes.
- Consulter les zones de couverture: accédez à 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 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 (United States Postal Service®) et sont utilisées avec son autorisation: United States Postal Service®, CASS™, CASS Certified™. ↩