Envoyez une requête de validation d'adresse en envoyant une requête POST à l'un des les 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"]
},
}
Champs de requête d'adresse
Le corps de la requête comprend un seul champ:
address
: champ de typePostalAddress
, qui doit contenir au moins une entrée dansaddressLines
.
Lorsque vous envoyez le champ address
à l'API Address Validation, il vous suffit simplement
Renseignez un champ: addressLines
. Cependant, la demande d'adresse
la plus simple
doit contenir les sous-champs suivants:
regionCode
— Recommandé. Ce champ est facultatif. Toutefois, s'il est omis, L'API Address Validation déduit la région à partir de l'adresse. Toutefois, pour mieux les résultats, incluezregionCode
si vous le connaissez. Pour obtenir la liste des régions disponibles, consultez la liste des régions où le service est disponible.addressLines
: obligatoire. Tableau d'adresses décrivant la structure inférieure de l'adresse.
Consultez PostalAddress dans le guide de référence. |
Option USPS CASSTM
Le service postal des États-Unis (United States Postal Service® ou USPS®)1 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 PR uniquement, vous pouvez activer le traitement CASS en définissant
enableUspsCass
à true
dans le corps de la requête. Pour des résultats optimaux lors de l'utilisation
CASS, fournissez une adresse comprenant la rue et le numéro, 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 de créer des exemples de requêtes afin de vous familiariser avec l'API et ses options.
Sélectionnez l'icône API , sur le côté droit de la page.
Vous pouvez également développer Afficher les paramètres standards et définir le paramètre
fields
sur le masque de champ.Vous pouvez également modifier le corps de la requête.
Sélectionnez le bouton Execute (Exécuter). Dans la boîte de dialogue, sélectionnez le compte que vous souhaitez utiliser pour effectuer la demande.
Dans le panneau APIs Explorer, sélectionnez l'icône de développement, , pour développer la fenêtre de l'explorateur d'API.
-
Google Maps Platform est un licencié non exclusif des États-Unis. Postal Service®. La ou les marques suivantes appartiennent aux États-Unis Postal Service® et utilisé avec autorisation: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩