Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Développeurs de l'Espace économique européen (EEE)
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.
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.
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.
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.
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™. ↩
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eThe Address Validation API validates, standardizes, and geocodes addresses, improving delivery predictability and customer experience.\u003c/p\u003e\n"],["\u003cp\u003eIt identifies address components, validates them for correctness, and provides suggestions for corrections, unlike the Geocoding API, which only converts addresses to coordinates.\u003c/p\u003e\n"],["\u003cp\u003eAddresses are processed by correcting, completing, and formatting components, with CASS™ support for US and Puerto Rico addresses for enhanced accuracy (requires enabling).\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access resources like a demo, coverage details, setup instructions, validation requests, response understanding, and client libraries to utilize the API effectively.\u003c/p\u003e\n"],["\u003cp\u003eUSPS evaluates requests for artificially created addresses, and Google is obligated to stop validation and report relevant information to USPS in such cases.\u003c/p\u003e\n"]]],["The Address Validation API validates and standardizes addresses, identifying components and correcting errors. It can infer missing information, and determine if an address is a real place. The API accepts an address, validates it, and returns a complete address or flags missing information. Users can confirm, correct, or provide missing details. For US and Puerto Rico addresses, CASS can be enabled for enhanced accuracy. The Geocoding API may be preferred if address component validation is not needed.\n"],null,["**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq). \n\nIntroduction The Address Validation API is a service that accepts an address. It identifies address components and validates them. It also standardizes the address for mailing and finds the best known latitude/longitude coordinates for it. Optionally, for addresses in the United States and Puerto Rico, you can enable the [Coding Accuracy Support System (CASS™)](https://developers.google.com/maps/documentation/address-validation/overview#about-cass).\n\nWhy use the Address Validation API\n\nWith the Address Validation API, you can improve delivery predictability and reduce\ndelivery failures, thereby providing improved customer experience. You do this\nby catching bad addresses and obtaining better awareness of address\ncharacteristics.\n\nThe Geocoding API might be a better match for your needs if you\ndon't need to validate the individual address components. The Geocoding API\n**converts** addresses into latitude and longitude coordinates. The\nAddress Validation API validates addresses for **correctness** . See\n[Building location validation capability using Google Maps Platform](https://developers.google.com/maps/architecture/geocoding-address-validation)\nin the Architecture Center for a detailed comparison.\n\nWhat you can do with the Address Validation API\n\n[inputTry the demo](/maps/documentation/address-validation/demo) [](/maps/documentation/address-validation/demo)\n\nWith the Address Validation API, you can determine if an address\nrefers to a real place. If the address does not refer to a real\nplace, the API can identify possibly wrong components that you can present to\nyour customers to correct. Here is a sample workflow using the API:\n\n1. **Customer enters an address** -- The following image shows a basic form\n that allows a customer to enter an address, possibly as part of a checkout\n flow.\n\n2. **App sends the address to the API** -- The application passes this address\n as the input to the Address Validation API.\n\n3. **API validates and standardizes the address** -- In its response, the\n Address Validation API returns the complete address as determined by the API, or\n indicates where information is missing.\n\n4. **Customer confirms or corrects the address** -- Depending on\n what the API returns, you can provide the following prompts to the customer:\n **A.** Confirm the recommended address. **B.** Provide missing information.\n **C.** Fix the address.\n\nHow the Address Validation API works\n\nThe address validation accepts a POST request with the address in the form\nof a JSON body. It separates the address into its individual components, and\nthen attempts the following:\n\n- **Corrects**---Provides component-level validation checks, including sub-premises where available.\n- **Completes**---Attempts to infer missing or incorrect address components.\n- **Formats**---Cleans up and standardizes the format for address components.\n\nResources\n\nThe following table summarizes the resources available through the\nAddress Validation API along with the data it returns. For specific details, see the\n[Address Validation API reference](./reference/rest).\n\n\u003cbr /\u003e\n\n| Data resources | Data returned |\n|-------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Address components in JSON format.** See [Validate an address](/maps/documentation/address-validation/requests-validate-address). | Complete, validated address (if possible). Validation status of each address component. Where available for an address: - Geocode - Address precision - Postal services data, where available. See [Understand the validation response](/maps/documentation/address-validation/understand-response). |\n\n\u003cbr /\u003e\n\nHow to use the Address Validation API\n\n|---|-----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Try the demo** | [Explore the demo](/maps/documentation/address-validation/demo) with a variety of address forms, both correct and incorrect. The demo provides a useful way to explore both the return values from the service, as well as the JSON formatted API response. |\n| 2 | **Check coverage** | Review [coverage details](/maps/documentation/address-validation/coverage) to see which countries and regions the Address Validation API supports. |\n| 3 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/address-validation/cloud-setup) and complete the instructions that follow. |\n| 4 | **Request an address validation** | Start with a basic address and then, for additional accuracy, you can enable CASS (for US and PR addresses only). See [Request an address validation.](/maps/documentation/address-validation/requests-validate-address) |\n| 5 | **Process a response** | The Address Validation API response provides two properties, each of which you use in different ways. See [Understand a basic response.](/maps/documentation/address-validation/understand-response) |\n| 6 | **Improve validation accuracy** | You can help improve address accuracy by providing feedback on Address Validation API responses. See [Handle updated addresses](/maps/documentation/address-validation/handle-updated-address). |\n\nAvailable client libraries\n\nFor a list of the available client libraries for Address Validation API,\nsee\n[Client libraries](/maps/documentation/address-validation/client_libraries).\n\nAbout CASS™\n\nThe United States Postal Service® (USPS®)^[1](#fn1)^ maintains the\n[Coding Accuracy Support System (CASS™)](https://postalpro.usps.com/certifications/cass)\nto support and certify address validation providers. A CASS Certified™ service,\nsuch as the Address Validation API, has been confirmed for its\nability to fill in information missing from an address, standardize it, and\nupdate it to give you the most current and most accurate address.\n\nCASS is not enabled by default and is only supported for the \"US\" and \"PR\"\nregions. To enable CASS, set `enableUspsCass` to `true` as part of a validation\nrequest. For more information, see\n[Validate an address](/maps/documentation/address-validation/requests-validate-address#enable-cass).\n\nAs part of our use of USPS services, USPS evaluates requests for artificially\ncreated addresses. If USPS identifies an input address as being artificially\ncreated, Google is required to stop validating addresses for the customer and\nmust report the customer's contact information (name and address), the relevant\ninput address, and aggregated usage data to USPS. By using the API you consent\nto these\n[Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms).\n\nWhat's next\n\n- **Try the demo** : Go to [Demo](/maps/documentation/address-validation/demo)\n- **Review coverage areas** : Go to [Country and region coverage details](/maps/documentation/address-validation/coverage)\n- **Try your first validation request** : Go to [Send an address validation request](/maps/documentation/address-validation/requests-validate-address)\n- **Process addresses at high volume** : Go to [Use Address Validation API to process addresses at high volume](/maps/architecture/high-volume-address-validation)\n\n*** ** * ** ***\n\n1. Google Maps Platform is a non-exclusive Licensee of the United States\n Postal Service®. The following trademark(s) are owned by the United States\n Postal Service® and used with permission: United States Postal Service®,\n CASS™, CASS Certified™. [↩](#fnref1)"]]
