Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Maps JavaScript API

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou sélectionner un projet
  2. Activer Google Maps JavaScript API et les services connexes
  3. Créer les clés appropriées
Continuer

Obtenir une clé/authentification

Toutes les applications Google Maps JavaScript API requièrent une authentification.

  • Utilisateurs de l'API standard : Si vous utilisez l'API dans le cadre du plan Standard, vous devez utiliser une clé d'API configurée dans le projet de votre choix. En savoir plus sur les clés d'API pour l'API standard.
  • Utilisateurs Premium Plan : Si vous utilisez l'API avec Google Maps APIs Premium Plan, vous disposez de deux options d'authentification :
    • Utilisez une clé d'API configurée dans le projet Google Maps APIs Premium Plan (créé pour vous lorsque vous avez acheté Premium Plan).
        ou
    • Utilisez votre ID client au lieu d'une clé d'API.

    Pour plus d'informations sur le choix de la meilleure méthode d'authentification, voir la section Google Maps APIs Premium Plan ci-dessous.

Authentification pour l'API standard — Clés d'API

Pour utiliser l'API standard, vous devez inclure une clé d'API lors du chargement de l'API.

Avantages de l'utilisation d'une clé d'API :

  • La clé d'API vous permet de surveiller l'utilisation de l'API de votre application dans la Google API Console. Pour plus d'informations, voir l'aide de la Google API Console.
  • Avec une clé, vous avez accès à un généreux quota journalier gratuit et vous avez la possibilité d'augmenter votre quota journalier en activant la facturation à l'utilisation.
  • L'inscription pour obtenir une clé d'API permet à Google de vous contacter à propos de votre application, le cas échéant.

Obtenir une clé d'API

Pour commencer à utiliser Google Maps JavaScript API, cliquez sur le bouton ci-dessous qui vous aidera automatiquement tout au long du processus d'activation de Google Maps JavaScript API et pour tous les services connexes.

Obtenir une clé

Vous pouvez également obtenir une clé d'API comme suit :

  1. Allez à la Google API Console.
  2. Créez ou sélectionnez un projet.
  3. Cliquez sur Continue pour activer l'API et les services connexes.
  4. Sur la page Credentials, procurez-vous une clé d'API (et définissez les restrictions de clé d'API).
    Remarque : Si vous avez une clé d'API sans restriction ou une clé avec des restrictions de navigateur, vous pouvez utiliser cette clé.
  5. Pour éviter le vol de quota, sécurisez votre clé d'API conformément aux meilleures pratiques suivantes.
  6. (facultatif) Activez la facturation. Pour plus d'informations, voir Limites d'utilisation.


Dans la Google API Console, vous pouvez également rechercher une clé existante ou afficher une liste des API activées.

Pour plus d'informations sur l'utilisation de la Google API Console, voir l'aide de la API Console.

Types de restrictions de clé d'API

Les Google Maps API sont disponibles pour les applications Android ou iOS, les navigateurs Web et via les services Web HTTP. Sur toute plateforme, les API peuvent utiliser une clé d'API générique (sans restriction). Vous pouvez éventuellement ajouter une restriction (par exemple, référent HTTP) à la clé d'API. Une fois restreinte, la clé fonctionne uniquement sur les plateformes qui prennent en charge ce type de restriction. En savoir plus sur les clés et les identifiants.

Spécifier une clé lors du chargement de l'API

Pour spécifier une clé, intégrez-la sous la forme d'une valeur de paramètre key lors du chargement de l'API.

Par exemple :

  <script async defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
  type="text/javascript"></script>

Authentification pour les clients Google Maps APIs Premium Plan

Les informations de cette section s'appliquent uniquement au nouveau Google Maps APIs Premium Plan, disponible à partir du 6 janvier 2016.

Vous possédez une ancienne licence Maps APIs for Work ou Maps API for Business ? Consultez notre guide des licences Maps APIs for Work. Pour déterminer si vous avez une ancienne licence : Dans le Google Cloud Support Portal, cliquez sur Maps: Usage Report sur la gauche. Si l'ID en haut du rapport est au format suivant, cela signifie que vous disposez de la nouvelle licence Premium Plan :
gme-[company] & proj-[number] ([type])
Sinon, cela signifie que vous avez une licence antérieure.

Lorsque vous utilisez Google Maps JavaScript API avec une licence Google Maps APIs Premium Plan, vous devez authentifier votre application avec une clé d'API ou un ID client. Remarque : Si vous disposez d'une licence Maps API for Business antérieure, vous devez utiliser un ID client et non pas une clé d'API.

Pour décider de la méthode d'authentification à utiliser, prenez en compte les informations suivantes :

  • Clé d'API (disponible pour les clients Google Maps APIs Premium Plan mais pas pour les titulaires d'une licence Maps API for Business antérieure) — En utilisant une clé d'API pour authentifier les requêtes, vous pouvez :
    • Gérer toutes vos API dans la Google API Console
    • Accéder en temps réel aux données d'utilisation et à un historique des données d'utilisation sur les 30 derniers jours pour votre application dans la Google API Console
    • Afficher des rapports d'utilisation avec plus de 30 jours de données dans le Google Cloud Support Portal
  • ID client — En utilisant votre ID client (au lieu d'une clé d'API) pour authentifier les requêtes, vous pouvez :
    • Ajouter le paramètre channel aux requêtes afin d'afficher des rapports d'utilisation plus détaillés
    • Afficher des rapports d'utilisation avec plus de 30 jours de données dans le Google Cloud Support Portal
    • Utiliser les outils Maps Analytics pour Maps JavaScript API

En savoir plus sur les rapports disponibles pour les clients Premium Plan.

Utiliser une clé d'API

Pour authentifier Google Maps JavaScript API à l'aide d'une clé d'API, cliquez sur le bouton ci-dessous pour obtenir de l'aide tout au long du processus d'obtention de la clé d'API.

Important : Dans le menu déroulant du projet, sélectionnez le projet créé pour vous lors de l'achat de Premium Plan. Le nom du projet commence par Google Maps APIs for Business or Google Maps for Work or Google Maps.*

Obtenir une clé

Vous pouvez également obtenir une clé d'API comme suit :

  1. Allez à la Google API Console.
  2. Dans le menu déroulant Project, sélectionnez le projet Google Maps Premium.*
  3. Cliquez sur Continue.
  4. Sur la page Credentials, procurez-vous une clé d'API (et définissez les restrictions de clé d'API).
    Remarque : Si vous avez une clé d'API sans restriction ou une clé avec des restrictions de navigateur, vous pouvez utiliser cette clé.
  5. Pour éviter le vol de quota, sécurisez votre clé d'API conformément aux meilleures pratiques suivantes.

* Remarque : Dans le menu déroulant du projet, vous devez sélectionner le projet créé pour vous lors de l'achat de Premium Plan. Le nom du projet commence par Google Maps APIs for Business or Google Maps for Work or Google Maps. Important : Si vous disposez d'une licence Maps API for Business antérieure, vous devez utiliser un ID client et non pas une clé d'API.


Vous pouvez également rechercher une clé existante dans la Google API Console.

Pour plus d'informations sur l'utilisation de la Google API Console, voir l'aide de la API Console.

Spécifier une clé lors du chargement de l'API

Pour spécifier une clé, intégrez-la sous la forme d'une valeur de paramètre key lors du chargement de l'API.

Par exemple :

  <script async defer src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
  type="text/javascript"></script>

Utiliser un ID client

L'authentification de Google Maps JavaScript API à l'aide d'un ID client (au lieu d'une clé d'API) requiert un ID client unique associé à l'enregistrement des URL.

Si vous utilisiez précédemment une clé d'API pour l'authentification et que vous allez désormais utiliser un ID client, vous devez supprimer le paramètre key avant de charger l'API. L'API ne se chargera pas si vous incluez à la fois un ID client et une clé d'API.

Votre ID client

Lors de l'achat de votre licence Google Maps APIs Premium Plan, vous recevrez de la part de Google un e-mail de bienvenue contenant votre ID client. Votre ID client permet d'accéder aux fonctionnalités spéciales de Google Maps APIs Premium Plan. Tous les ID client commencent par le préfixe gme-.

Cet ID client n'est pas une clé. Il fonctionnera uniquement à partir des URL que vous autorisez, donc vous ne devez pas vous soucier de le garder secret.

Spécifier un ID client lors du chargement de l'API

Spécifiez votre ID client en tant que valeur d'un paramètre client lors du chargement de Google Maps JavaScript API :

<script async defer src="https://maps.googleapis.com/maps/api/js?client=YOUR_CLIENT_ID &v=3.26&callback=initMap"></script>

Comme illustré dans l'exemple ci-dessus, vous devez spécifier la version Release (également appelée la version stable) ou une version précédente, en ajoutant un paramètre v=3.26. Les applications qui utilisent la version expérimentale ne sont pas couvertes par le contrat de niveau de service de Google Maps APIs Premium Plan.

Enregistrer les URL autorisées

Afin d'empêcher les tiers d'utiliser votre ID client sur leur propre site Web, l'utilisation de votre ID client est limitée à une liste d'URL que vous autorisez spécifiquement.

Pour consulter les URL que vous avez déjà autorisées ou pour autoriser d'autres URL :

  1. Connectez-vous au Google Cloud Support Portal.
  2. Dans le menu de gauche, cliquez sur Maps: Manage Client ID.

Vous pouvez ajouter jusqu'à 100 URL à la fois, jusqu'à un total de 3 000 URL. Si vous avez besoin de limites plus élevées, contactez le support.

Les points suivants concernent les URL qui sont autorisées :

Le nom de domaine ou l'adresse ne doit pas être accessible publiquement.
Par exemple, http://myintranet et http://192.168.1.1 sont des entrées valides.
Tous les sous-domaines d'un domaine spécifié sont également autorisés.
Par exemple, si http://example.com est autorisé, alors http://www.example.com est également autorisé. L'inverse n'est pas vrai : si http://www.example.com est autorisé, http://example.com n'est pas forcément autorisé.
Tous les sous-chemins d'un chemin d'accès autorisé sont également autorisés.
Par exemple, si http://example.com est autorisé, alors http://example.com/foo est également autorisé. En outre, puisque les sous-domaines d'un domaine spécifié sont également autorisés, http://sub.example.com/bar est autorisé.
Les chemins d'accès doivent respecter la casse.
Par exemple, http://www.example.com/ThisPath/ est différent de http://www.example.com/thispath/.
Vous pouvez limiter les URL valides à celles utilisant certains ports.
Par exemple, si http://example.com:8080/foo est spécifié, cela n'autorise pas http://example.com.
Les protocoles HTTP et HTTPS sont considérés comme des URL différentes.
Par exemple, si https://example.com est autorisé, http://example.com n'est pas forcément autorisé. Si vous souhaitez autoriser les deux simultanément, vous pouvez ajouter un domaine sans utiliser de protocole : example.com/

Toutes les règles ci-dessus sont appliquées à chaque autorisation, c'est pourquoi vous devez veiller à planifier minutieusement vos autorisations. Par exemple, puisque tous les sous-chemins d'un chemin d'accès spécifié sont autorisés, ainsi que tous ses sous-domaines, vous pourriez autoriser certaines pages alors que vous n'en aviez pas l'intention. Par exemple :

http://example.com/ autorise également http://sub.example.com/path.

Plus d'informations, voir Résolution des erreurs d'autorisation Google Maps APIs Premium Plan.

Envoyer des commentaires concernant…

Google Maps JavaScript API
Google Maps JavaScript API
Besoin d'aide ? Consultez notre page d'assistance.