Guide pour obtenir sa clé API Google Maps en toute simplicité

Google Maps a été acquis par Google en 2004, provenant de la start-up australienne Where 2 Technologies. Il a été initialement lancé aux États-Unis, au Canada et en Grande-Bretagne en 2005. C’est en 2006 que Google Maps a été introduit en France, ainsi que dans d’autres pays tels que l’Allemagne et l’Italie.

L’application offre des fonctionnalités telles que la recherche d’itinéraires pour la conduite, la marche et le vélo, des vues panoramiques avec Street View, la localisation d’entreprises avec avis et photos, ainsi que des informations en temps réel sur le trafic. 

Elle regorge également de fonctionnalités avancées via l’utilisation de son API qu’on peut retrouver sur gcloud. Pour cela, la première étape est de récupérer cette fameuse clé API. A travers cet article, nous allons voir ensemble ce qu’est une clé API, les différents services chez Google, et comment les obtenir, mais surtout on verra comment faire la récupérer et exploiter l’API dans une page ou dans un projet.

Son API est également une préférence des développeurs dès lors qu’il s’agit d’ajouter des maps sur un site. Nous allons voir comment récupérer cette clé à travers la console gcloud.

Qu’est ce qu’une clé API ?

Avant d’aller plus loin sur les concepts d’API, il est important de comprendre le jargon, comme la notion de clé, ou key qu’on peut retrouver dans de nombreuses documentations de Gcloud.

Une clé API, ou key d’interface de programmation, est une chaîne de caractères (string) générée par un service en ligne pour identifier une application, un développeur ou un utilisateur spécifique et autoriser l’accès à des fonctionnalités ou des données.

En d’autres termes, une key API fonctionne comme un « mot de passe » permettant aux applications d’obtenir et restreindre l’accès à certaines fonctionnalités ou données fournies par un service tiers. Cette approche est utilisée pour contrôler l’accès aux ressources en ligne et pour suivre l’utilisation des services. Dans un projet, c’est un service qui permet de connecter plusieurs services, que ce soit pour connecter des applications entre elles, les lier à des serveurs, ou encore faire le lien entre des applications/serveurs et des clients. 

Ainsi, cela permet de protéger contre les utilisations non autorisées en limitant les appels d’API ou au SDK spécifique aux personnes qui fournissent des identifiants d’authentification appropriés. 

Créer une clé API Google Map

1. Première étape : créer un compte Google Cloud Platform

Afin d’utiliser les API Google Maps, vous devez disposer d’un compte Google Cloud Platform (GCP), un autre service de Google et activer le service concerné. Si vous n’avez pas encore de compte GCP, rendez-vous sur la page d’accueil de Google Cloud et cliquez sur « Get Started for Free » (Essai gratuit) pour suivre la procédure d’inscription. Attention, il est impératif de posséder un compte Gmail au préalable. Si vous n’avez pas encore de compte Gmail, vous devez en créer un avant de pouvoir profiter des services API Google Maps.

Après avoir créé votre compte GCP, il est temps de passer à la configuration du projet et de l’API.

2. Deuxième étape : créer et configurer un projet GCP

Dans ce deuxième volet, voici les étapes à suivre pour créer et configurer un projet sur Google Cloud Platform et obtenir les clés de l’API :

1. Connectez-vous à votre compte GCP (Google Cloud Plateform) et accédez au Tableau de bord.
2. En haut à droite, vous trouverez un sélecteur de projet (icône en forme de dossier) ; cliquez dessus pour ouvrir l’écran des projets. Il se peut que vous ayez déjà un projet par défaut, mais il est recommandé d’en créer un dédié aux API Google Maps.
3. Cliquez sur le bouton « + » pour ajouter un nouveau projet et donnez-lui un nom. Validez la création du projet en cliquant sur « Create » (Créer).
4. Une fois le projet créé, sélectionnez-le comme projet actif en utilisant à nouveau le sélecteur de projet.

Maintenant que votre projet GCP est prêt, il est temps de passer à l’activation de l’API Google Maps souhaitée. 

3. Troisième étape : activer une API Google Maps

Google propose plusieurs types d’API en lien avec les cartes et la géolocalisation. En fonction de vos besoins, vous pouvez choisir d’activer l’une ou plusieurs de ces API. Pour ce faire :

1. Dans le Tableau de bord GCP, accédez au menu latéral gauche et cliquez sur « API & Services » puis « Bibliothèque ».
2. Recherchez l’API Google Maps que vous souhaitez utiliser, par exemple « Maps JavaScript API » pour afficher des cartes interactives sur un site Web.
3. Cliquez sur l’API sélectionnée pour accéder à sa page de détails, puis cliquez sur « Activer » pour l’ajouter à votre projet.

Avec l’API activée, il ne vous reste plus qu’à générer la clé API que vous utiliserez pour exploiter les fonctionnalités de Google Maps dans vos développements.

4. Quatrième étape : créer sa clé API Google Maps

Pour générer et récupérer la clé API :

1. Toujours sur la page de détails de l’API précédemment activée, cliquez sur le bouton « Créer des identifiants ».
2. Un nouveau panneau s’affiche. Sélectionnez « apikeys » comme type d’identifiant.
3. La clé API sera alors automatiquement générée. Copiez-la précieusement car elle sera nécessaire dans votre code pour faire appel aux services Google Maps.
4. Cliquez sur « Fermer » pour revenir au Tableau de bord.

Vous avez désormais votre clé API en main ! Il ne vous reste plus qu’à passer à l’import de la key sur votre site Web ou votre application mobile pour profiter des services offerts par Google Maps. N’oubliez pas de partager toujours vos keys en sha pour votre application. Faites également attention à ne pas l’afficher dans une url, de manière public

5. Cinquième étape : Ajout de la clé API Google Maps à votre application 

Pour importer votre clé API dans votre projet, en fonction du langage de programmation (java, python, javascript etc.) dont vous allez utiliser, il faudra alors adapter son utilisation.

Prenons l’exemple d’un projet en javascript, Il faudra utiliser la clé API dans votre code JavaScript de la manière suivante : 

   <script src="https://maps.googleapis.com/maps/api/js?key=APIKEYS&callback=initMap"  

En faisant bien attention de remplacer Assurez-vous de remplacer « APIKEYSI » par votre propre clé API. Cette clé est utilisée pour authentifier votre application et lui permettre d’accéder à l’API Google Maps.

Restreindre l’utilisation de sa key API et protéger son compte Google Cloud Platform

1. Types de clés API

Attention, il est est essentiel pour déverrouiller tout le potentiel de cette puissante plateforme cartographique de connaître les différents types de clés API Google Maps. En effet, chacun apporte son lot d’autorisations et de fonctionnalités spécifiques :

1. Clé API pour les applications Android :

• Utilisation : Intégration de cartes Google Maps dans des applications Android.
• Activation : Dans la console Google Cloud Platform, activez l’API Maps SDK for Android et créez une clé API dédiée.

2. Clé API pour les applications iOS :

• Utilisation : Intégration de cartes Google Maps dans des applications iOS.
• Activation : Dans la console Google Cloud Platform, activez l’API Maps SDK for iOS et créez une clé API associée.

3. Clé API pour les applications Web (Javascript) :

• Utilisation : Intégration de cartes Google Maps dans des applications web utilisant JavaScript.
• Activation : Dans la console Google Cloud Platform, activez l’API Maps JavaScript et créez une clé API appropriée.

4. Clé API pour les applications géolocalisées :

• Utilisation : Accès à des fonctionnalités de géolocalisation dans une application.
• Activation : Dans la console Google Cloud Platform, activez l’API Geolocation et créez une clé API dédiée.

5. Clé API pour les applications Street View :

• Utilisation : Intégration de fonctionnalités Street View dans des applications.
• Activation : Dans la console Google Cloud Platform, activez l’API Street View et créez une clé API spécifique.

Choisir le bon type de clé API est crucial pour exploiter pleinement les fonctionnalités de Google Maps. Veillez à configurer correctement les autorisations et les restrictions d’utilisation pour assurer la sécurité de votre clé API.

2. Limite de l’utilisation de l’API dans un projet/page

Comme expliqué précédemment, l’utilisation des keys API est obligatoire pour les projets et les applications qui font usage des API et des SDK Google Maps Platform. Partager ses identifiants, même en transformant en sha dans une url, ne permet pas de limiter les restrictions. Il est fréquent de voir que les keys soient accessibles, et que les restrictions ne soient pas respectées : import dans un fichier public, import sur le web etc. 

Pour assurer un niveau élevé de sécurité avec un minimum d’efforts, il est recommandé de sécuriser vos clés API lors de leur création. En effet, il est conseillé de mettre en place des restrictions d’utilisation afin de protéger votre compte GCloud contre d’éventuels abus. Par exemple, dans votre projet, limitez les domaines autorisés à utiliser votre clé.

Pour configurer ces restrictions :

1. Revenez à la page « API & Services » puis cliquez sur « Identifiants ».
2. Trouvez votre clé API dans la liste et cliquez sur le crayon pour accéder aux paramètres de modification.
3. Dans l’onglet « Restrictions », configurez les limitations que vous jugez appropriées, puis cliquez sur « Enregistrer ».
4. Par SHA-1 et Nom d’Application : Pour renforcer la sécurité, vous pouvez restreindre l’utilisation de votre clé API en ajoutant des restrictions par SHA-1 (empreinte numérique du certificat de votre application) et par nom d’application. Cela se fait en ajoutant ces informations lors de la création de la clé.

En suivant ces recommandations, vous garantissez une utilisation sécurisée et maîtrisée de votre key API Google Maps et profitez sereinement des fonctionnalités avancées offertes par ce service.