Aide-mémoire de l'API Address Validation

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 uspsData pour 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

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é addressComplete est omise du verdict lorsque sa valeur est false. 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é addressComplete manquante comme false ou vérifiez la présence de la propriété. Consultez /maps/documentation/address-validation/understand-response.
  • Problème : Si regionCode est omis, l'API déduit la région à partir de l'adresse, ce qui peut donner des résultats moins précis. Correction : incluez regionCode dans PostalAddress lorsque vous le connaissez. Consultez /maps/documentation/address-validation/requests-validate-address.
  • Problème : Il n'est pas garanti que l'objet uspsData soit entièrement renseigné pour chaque adresse américaine validée. Correction : Ne vous fiez pas uniquement à uspsData comme 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 provideValidationFeedback doivent faire référence au responseId du premier appel validateAddress de la séquence, et non à un appel ultérieur. Correction : Stockez le responseId de la première réponse validateAddress et 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.