API Places : obtenir une clé API

Remarque : Il n'est plus possible de s'inscrire au forfait Premium Google Maps Platform, et il n'est plus disponible non plus pour les nouveaux clients.

Pour utiliser l'API Places, vous devez disposer d'une clé API. La clé API est un identifiant unique qui permet d'authentifier les requêtes associées à votre projet à des fins d'utilisation et de facturation.

En utilisant une clé API pour authentifier les requêtes, vous pouvez :

En savoir plus sur les rapports disponibles pour les clients du forfait Premium

Créer des clés API

Vous devez associer au moins une clé API à votre projet.

Pour obtenir une clé API, procédez comme suit :

  1. Accédez à la console Google Cloud Platform.
  2. Cliquez sur la liste déroulante des projets et sélectionnez celui qui a été créé pour vous lorsque vous avez acheté le forfait Premium. Le nom du projet commence par Google Maps APIs for Business, Google Maps for Work ou Google Maps.
  3. Remarque : Si vous avez souscrit un forfait Premium, pour accéder à toutes les fonctionnalités, vous devez utiliser le projet associé à votre compte Premium. Lorsque vous avez acheté votre licence, vous avez reçu le nom de l'élément Premium au format suivant : gme-[company] & proj-[number] ([type]). Pour vous assurer que vous accédez au bon projet, connectez-vous à la console en tant que propriétaire du projet sur console.cloud.google.com/project/number (remplacez number par votre numéro de projet). Vous trouverez le propriétaire du projet dans la lettre de bienvenue.

  4. Cliquez sur le bouton Menu , puis sélectionnez API et services > Identifiants.
  5. Sur la page Identifiants, cliquez sur Créer des identifiants > Clé API.
    La boîte de dialogue Clé API créée affiche la nouvelle clé API (une chaîne chiffrée).
  6. Cliquez sur Fermer.
    La nouvelle clé API est répertoriée sur la page Identifiants sous Clés API.

Ajouter la clé API à votre requête

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

https://maps.googleapis.com/maps/api/place/nearbysearch/json
  ?location=-33.8670522,151.1957362
  &radius=500
  &types=food
  &name=harbour
  &key=YOUR_API_KEY

Restreindre les clés API

Restreindre les clés API permet de renforcer la sécurité de votre application, car vous vous assurez que seules les requêtes autorisées sont effectuées avec votre clé API. Nous vous recommandons vivement de suivre les instructions pour définir des restrictions au niveau de vos clés API. Pour en savoir plus, consultez les bonnes pratiques concernant les clés API.

Pour restreindre une clé API :

  1. Dans la console GCP, sur la page du sélecteur de projet, sélectionnez ou créez un projet Google Cloud pour lequel vous souhaitez ajouter une clé API.

    Accéder à la page du sélecteur de projet

  2. Accédez à la page API et services > Identifiants.

    Accéder à la page "Identifiants"

  3. 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.
  4. 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.
      2. Spécifiez une adresse IPv4 ou IPv6, ou un sous-réseau au format CIDR (192.168.0.0/22, par exemple). Si vous devez saisir une autre entrée, une nouvelle zone apparaît dès que vous avez terminé l'entrée précédente.
    • Restrictions relatives aux API
      1. Cliquez sur Restreindre la clé.
      2. Sélectionnez API Places dans la liste déroulante Sélectionner des API.
        (Si l'API Places n'est pas répertoriée, vous devez l'activer.)
  5. Pour finaliser vos modifications, cliquez sur Enregistrer.

Résoudre les problèmes d'authentification

Si le format de votre requête est incorrect ou fournit une signature non valide, l'API Places renvoie une erreur HTTP 403 (Forbidden).

Pour résoudre les problèmes liés aux URL individuelles, vous pouvez utiliser l'outil URL Signing Debugger. Il vous permet de valider rapidement les URL et les signatures générées par votre application.

Les clients du forfait Premium peuvent également résoudre les problèmes liés aux URL en se connectant au portail d'assistance Google Cloud, puis en sélectionnant Ressources > Outils en ligne du forfait Premium Google Maps Platform > URL Signing Debugger pour les API Web Service et Image.