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)

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"]
  },
}

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

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 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. Si vous l'omettez, l'API Address Validation déduit la région à partir de l'adresse. Toutefois, pour de meilleurs résultats, incluez le regionCode si vous le connaissez. Pour obtenir la liste des régions compatibles, consultez Régions compatibles.
• addressLines : obligatoire. Tableau contenant les adresses décrivant la structure inférieure de l'adresse.

Option USPS CASS™

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

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 les meilleurs résultats avec CASS, fournissez une adresse qui inclut 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
}

Essayer

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

1. Sélectionnez l'icône API api à droite de la page.

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

3. Sélectionnez le bouton Exécuter. Dans la boîte de dialogue, sélectionnez le compte que vous souhaitez utiliser pour envoyer la demande.

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