Utiliser des clés API avec l'API Address Validation

Développeurs situés dans l'Espace économique européen (EEE)

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

Les produits Google Maps Platform sont protégés contre les utilisations non autorisées en limitant les appels d'API aux personnes qui fournissent des identifiants d'authentification appropriés. Ces identifiants se présentent sous la forme d'une clé API, qui correspond à une chaîne alphanumérique unique qui associe votre compte de facturation Google à votre projet, ainsi qu'à l'API ou au SDK spécifique.

Ce guide explique comment créer, restreindre et utiliser votre clé API pour Google Maps Platform.

Avant de commencer  : pour utiliser l'API Address Validation, vous devez disposer d'un projet associé à un compte de facturation et avoir activé les API suivantes : l'API Address Validation . Nous vous recommandons de désigner plusieurs propriétaires de projet et administrateurs de la facturation afin d'avoir toujours quelqu'un de disponible pour ces rôles dans votre équipe. Pour en savoir plus, consultez Configurer vos projets dans la console Cloud.

Créer des clés API

Une clé API est un identifiant unique qui permet d'authentifier les requêtes associées à votre projet à des fins d'utilisation et de facturation. Vous devez associer au moins une clé API à votre projet.

Pour créer une clé API :

Console

1. Accédez à la page Google Maps Platform > Identifiants.

   Accéder à la page "Identifiants"

2. Sur la page Identifiants, cliquez sur Créer des identifiants > Clé API.
   La boîte de dialogue Clé API créée affiche la clé API que vous venez de créer.
3. Cliquez sur Fermer.
   La nouvelle clé API figure sur la page Identifiants sous Clés API.
   (N'oubliez pas de restreindre la clé API avant de l'utiliser en production.)

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

En savoir plus sur le Google Cloud SDK, l'installation du Cloud SDK et les commandes suivantes :

• gcloud services api-keys create

Restreindre les clés API

Google vous recommande vivement de restreindre vos clés API en limitant leur utilisation aux seules API nécessaires à votre application. Restreindre les clés API vous aide à renforcer la sécurité de votre application en la protégeant contre les requêtes non justifiées. Vous êtes responsable financièrement des frais générés par une utilisation abusive de clés API sans restriction. Pour en savoir plus, consultez les bonnes pratiques de sécurité pour les API.

Lorsque vous restreignez une clé API dans la console Cloud, les restrictions liées aux applications s'appliquent à toutes les API activées dans Restrictions relatives aux API. Suivez les bonnes pratiques en créant une clé API distincte pour chaque application et pour chaque plate-forme sur laquelle cette application est disponible.

Pour restreindre une clé API :

Console

1. Accédez à la page Google Maps Platform > Identifiants.

   Accéder à la page "Identifiants"

2. Sélectionnez la clé API pour laquelle vous souhaitez définir une restriction. La page des propriétés de la clé API s'affiche.
3. Sous Restrictions relatives aux clés, définissez les restrictions suivantes :
• Restrictions relatives aux applications :
1. Pour accepter les requêtes de la liste des adresses IP de serveurs Web que vous fournissez, sélectionnez Adresses IP (serveurs Web, tâches Cron, etc.) dans la liste des restrictions relatives aux applications. À l'aide de la notation CIDR, indiquez une ou plusieurs adresses IPv4 ou IPv6, ou encore des sous-réseaux. Les adresses IP doivent correspondre à l'adresse source relevée par les serveurs de Google Maps Platform. Si vous utilisez la traduction d'adresse réseau (NAT), cette adresse correspond généralement à l'adresse IP publique de votre machine.
• Restrictions relatives aux API :
1. Cliquez sur Restreindre la clé.
2. Sélectionnez API Address Validation dans le menu déroulant Sélectionner des API. Si l'API Address Validation ne figure pas dans la liste, vous devez l'activer.
4. Pour valider les modifications, cliquez sur Enregistrer.
   

Cloud SDK

Listez les clés existantes.

gcloud services api-keys list --project="PROJECT"

Supprimez les restrictions existantes sur la clé existante.

gcloud services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

Définissez de nouvelles restrictions pour la clé existante.

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=addressvalidation.googleapis.com
    --allowed-ips="IP_ADDRESS"

En savoir plus sur le Google Cloud SDK, l'installation du Cloud SDK et les commandes suivantes :

• gcloud services api-keys update
• gcloud services api-keys lookup
• gcloud services api-keys list

Ajouter la clé API à votre requête

Vous devez inclure une clé API dans chaque requête de l'API Address Validation. Dans l'exemple suivant, remplacez YOUR_API_KEY par votre clé API.

https://addressvalidation.googleapis.com/v1:validateAddress?key=YOUR_API_KEY

HTTPS est requis pour les requêtes qui utilisent une clé API.

Remarque:Lorsque vous utilisez des services Web, tous les caractères spéciaux des paramètres doivent être encodés au format URL. Pour être valides, les URL doivent être correctement encodées et ne pas dépasser 2 048 caractères pour tous les services Web. Tenez compte de cette limite lorsque vous créez vos URL. Les différents navigateurs, proxys et serveurs peuvent également avoir des limites de caractères différentes pour les URL.