L'API Address Validation accepte une adresse, identifie ses composants et les valide, standardise l'adresse pour la distribution postale, et renvoie les meilleures coordonnées de latitude/longitude connues pour cette adresse. Pour les adresses aux États-Unis et à Porto Rico, vous pouvez éventuellement activer le traitement USPS CASS.
API Address Validation : informations clés
- Produit : API Address Validation
- Catégorie : Lieux
- Plate-forme : service Web (REST)
- S'exécute sur : le serveur (code backend)
- Étape de lancement : GA
- Cycle de vie : Actif
- Présentation : Présentation de l'API Address Validation
- Disponibilité régionale : limitée. Les pays compatibles et la qualité des données varient selon les pays, et certains pays sont en version preview. Les métadonnées résidentielles et commerciales ne sont renvoyées que pour les pays signalés sur la page de couverture. USPS CASS n'est disponible que pour les États-Unis et Porto Rico. (détails de la couverture)
API Address Validation : quand l'utiliser
Utilisez l'API Address Validation dans les cas suivants :
- Vous devez vérifier si une adresse correspond à un lieu réel et identifier les composants manquants ou potentiellement incorrects.
- Vous devez standardiser et compléter une adresse pour la distribution postale, par exemple lors d'un processus de paiement.
- Vous devez disposer d'une validation certifiée USPS CASS et de
uspsDatapour les adresses aux États-Unis ou à Porto Rico. - Vous devez disposer de métadonnées d'adresse résidentielle ou commerciale pour un pays figurant sur la page de couverture.
N'utilisez pas l'API Address Validation dans les cas suivants :
- Vous n'avez besoin que de convertir une adresse en latitude/longitude et vous n'avez pas besoin de valider les composants d'adresse individuels. Utilisez plutôt l'API Geocoding.
- Vous avez besoin d'informations hyper-locales sur la destination, telles que les entrées de bâtiments, les contours de bâtiments ou les points de navigation. Utilisez plutôt l'API Geocoding.
API Address Validation : configuration
- Service à activer :
addressvalidation.googleapis.com - Authentification : clé API, OAuth 2.0, compte de service
- Premiers pas : Configurer l'API Address Validation
- Référence : Documentation de référence de l'API Address Validation
- Tarifs : Utilisation et facturation de l'API Address Validation
- Règles : Règles de l'API Address Validation
- Notes de version : Notes de version de l'API Address Validation
Packages officiels de l'API Address Validation :
- npm :
@googlemaps/addressvalidation - pypi :
google-maps-addressvalidation - go :
cloud.google.com/go/maps
API Address Validation : erreurs courantes
- Problème : La propriété
addressCompleteest omise du verdict lorsque sa valeur estfalse. Par conséquent, le code qui s'attend à ce que le champ soit présent peut mal interpréter les adresses incomplètes. Correction : Traitez une propriétéaddressCompletemanquante commefalseou vérifiez la présence de la propriété. Consultez /maps/documentation/address-validation/understand-response. - Problème : Si
regionCodeest omis, l'API déduit la région à partir de l'adresse, ce qui peut donner des résultats moins précis. Correction : incluezregionCodedansPostalAddresslorsque vous le connaissez. Consultez /maps/documentation/address-validation/requests-validate-address. - Problème : Il n'est pas garanti que l'objet
uspsDatasoit entièrement renseigné pour chaque adresse américaine validée. Correction : Ne vous fiez pas uniquement àuspsDatacomme signal de validation. Utilisez également le verdict et les composants d'adresse. Consultez /maps/documentation/address-validation/handle-us-address. - Problème : Les commentaires envoyés avec
provideValidationFeedbackdoivent faire référence auresponseIddu premier appelvalidateAddressde la séquence, et non à un appel ultérieur. Correction : Stockez leresponseIdde la première réponsevalidateAddresset envoyez-le dans la demande de commentaires. Consultez /maps/documentation/address-validation/handle-updated-address.
Ce que vous pouvez faire avec l'API Address Validation
Consultez les guides associés ci-dessous pour chaque tâche ou comparez les produits dans l'explorateur de fonctionnalités.
- Renvoyez une adresse validée pour une adresse spécifiée ou une adresse partielle.
- Renvoyez les coordonnées de latitude/longitude d'une adresse validée.
- Renvoyez l'identifiant de lieu Google pour une adresse validée.
- Utilisez la certification CASS (Coding Accuracy Support System) du service postal des États-Unis (USPS) pour la validation des adresses.
- Déterminez si une adresse validée correspond à une entreprise, à une résidence ou à une boîte postale.
- Renvoyer les métadonnées de livraison du service postal des États-Unis (USPS) pour une adresse validée.
- Renvoyer une version en anglais d'une adresse validée Preview
- Renvoyer le Plus Code d'une adresse validée