Envoyer une requête de validation d'adresse

Développeurs de l'Espace économique européen (EEE)

Si votre adresse de facturation se trouve dans l'Espace économique européen, les Conditions d'utilisation de Google Maps Platform pour l'EEE s'appliqueront à votre utilisation des Services à compter du 8 juillet 2025. La fonctionnalité varie selon la région. En savoir plus

Envoyez une requête Address Validation en envoyant une requête POST à l'un des points de terminaison suivants :

• validateAddress (REST)
• ValidateAddress (gRPC)

Remarque : Cette documentation utilise REST pour ses exemples, mais l'approche est similaire avec gRPC.

Votre requête doit également transmettre un corps de requête JSON qui définit l'adresse à valider. Le corps de la requête suivant contient un champ et trois sous-champs :

curl -X POST -d '{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  }
}' \
-H 'Content-Type: application/json' \
"https://addressvalidation.googleapis.com/v1:validateAddress?key=API_KEY"

Vous pouvez également omettre locality et le spécifier en tant qu'élément dans le tableau addressLines :

{
  "address": {
    "regionCode": "US",
    "addressLines": ["1600 Amphitheatre Pkwy", "Mountain View, CA, 94043"]
  },
}

APIs Explorer vous permet d'effectuer des requêtes en direct afin de vous familiariser avec l'API et ses options :

Essayer

Champs de requête d'adresse

Le corps de la requête se compose d'un seul champ :

• address : champ de type PostalAddress, qui doit contenir au moins une entrée dans addressLines.

Lorsque vous envoyez le champ address à l'API Address Validation, vous ne devez fournir qu'un seul champ : addressLines. Toutefois, la requête d'adresse la plus simple doit contenir les sous-champs suivants :

• regionCode : recommandé. Ce champ est facultatif, mais s'il est omis, l'API Address Validation déduit la région à partir de l'adresse. Toutefois, pour des résultats optimaux, incluez le regionCode si vous le connaissez. Pour obtenir la liste des régions prises en charge, consultez Régions prises en charge.
• addressLines : obligatoire. Tableau contenant des adresses décrivant la structure inférieure de l'adresse.

Consultez PostalAddress dans le guide de référence.

Option USPS CASS™

Le service postal des États-Unis (United States Postal Service® ou USPS®)¹ gère le système CASS™ (Coding Accuracy Support System) afin d'aider et de certifier les fournisseurs de validation d'adresse.

Remarque : L'API Address Validation est confirmée en tant que service certifié CASS™. Cela signifie que le service est confirmé pour sa capacité à compléter les informations d'adresse manquantes, à les standardiser et à les mettre à jour avec l'adresse la plus récente et la plus précise.

Pour les régions des États-Unis et de Porto Rico uniquement, vous pouvez activer le traitement CASS en définissant enableUspsCass sur true dans le corps de la requête. Pour obtenir de meilleurs résultats avec CASS, indiquez une adresse comprenant la rue et le numéro de rue, ainsi que la ville, l'État et le code postal :

{
  "address": {
    "regionCode": "US",
    "locality": "Mountain View",
    "administrativeArea": "CA",
    "postalCode": "94043",
    "addressLines": ["1600 Amphitheatre Pkwy"]
  },
  "enableUspsCass": true
}

Remarque : Si vous n'avez pas besoin du traitement CASS ou si vous validez des adresses en dehors des États-Unis et de Porto Rico, Google vous déconseille d'activer cette fonctionnalité.

Essayer

APIs Explorer vous permet d'effectuer des exemples de requêtes afin de vous familiariser avec l'API et ses options.

1. Sélectionnez l'icône API api sur le côté droit de la page.

2. Vous pouvez modifier les paramètres de la requête.

3. Sélectionnez le bouton Exécuter. Dans la boîte de dialogue, choisissez le compte que vous souhaitez utiliser pour effectuer la requête.

4. Dans le panneau APIs Explorer, sélectionnez l'icône Plein écran fullscreen pour agrandir la fenêtre APIs Explorer.

---

1. 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 (USPS®) et sont utilisées avec son autorisation : United States Postal Service®, CASS™, CASS Certified™. ↩