Envoyer une requête de validation d'adresse

Envoyez une requête de validation d'adresse 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 à la requête qui définit l'adresse à valider. Le corps de 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"]
  },
}

Essayer

Champs de demande 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 n'avez besoin de renseigner qu'un seul champ: addressLines. Cependant, la demande 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 de l'adresse. Toutefois, pour de meilleurs résultats, incluez regionCode si vous le connaissez. Pour obtenir la liste des régions acceptées, consultez la section Régions où le service est disponible.
• addressLines : obligatoire. Tableau contenant des adresses décrivant la structure inférieure de l'adresse.

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

Option USPS CASSTM

Le service postal américain (USPS®)¹ gère le système CASSTM (Coding Accuracy Support System) afin d'assurer la compatibilité et la certification des fournisseurs de validation d'adresse.

Remarque :L'API Address Validation est reconnue comme un service CASS-CertifiedTM. Cela signifie que le service est confirmé pour sa capacité à renseigner les informations d'adresse manquantes, à les standardiser et à les mettre à jour avec l'adresse la plus récente et la plus précise.

Vous pouvez activer le traitement CASS (États-Unis) et PR uniquement en définissant enableUspsCass sur true dans le corps de la requête. Pour de meilleurs résultats lorsque vous utilisez le service CASS, fournissez une adresse incluant 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 de traiter CASS, ou si vous validez des adresses en dehors des États-Unis et des régions PR, Google vous déconseille d'activer cette fonctionnalité.

Essayer

API Explorer vous permet de créer des exemples de requêtes afin de vous familiariser avec l'API et ses options.

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

2. Vous pouvez également développer la section Afficher les paramètres standards et définir le paramètre fields sur le masque de champ.

3. Vous pouvez également modifier le corps de la requête.

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

5. Dans le panneau de l'explorateur d'API, sélectionnez l'icône de développement pour développer la fenêtre de l'explorateur d'API.

---

1. Google Maps Platform est un Titulaire de la licence non exclusif du service postal américain®. La ou les marques suivantes sont la propriété du service Postal Service® des États-Unis et sont utilisées avec autorisation: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩