Qu’est-ce qu’une clé API Google Sheets ?
Après avoir créé votre propre version des cartes Leaflet avec Google Sheets ou des récits Leaflet avec Google Sheets, il existe deux façons de finaliser votre carte, comme décrit ci-dessus : soit en enregistrant vos onglets Google Sheets au format CSV, soit en obtenant votre propre clé API Google Sheets et en la collant dans votre code Leaflet sur GitHub. Dans cette section, nous vous expliquerons cette dernière méthode.
À partir de janvier 2021, la version 4 de Google Sheets exige une clé API (interface de programmation d’application) pour permettre au code de lire vos données, afin de maintenir des limites raisonnables d’utilisation de ses services. Pour Google Sheets, la limite est de 500 requêtes par tranche de 100 secondes par projet, et de 100 requêtes par tranche de 100 secondes par utilisateur. Il n’y a pas de limite d’utilisation quotidienne.
Obtenez votre propre clé API Google Sheets
Voici comment obtenir votre propre clé API Google Sheets gratuitement :
Avant de commencer :
- Vous avez besoin d’un compte Google personnel, et non d’un compte Google Suite délivré par votre école ou votre entreprise.
- Ce tutoriel suppose que vous avez déjà finalisé les cartes Leaflet avec Google Sheets ou les récits Leaflet avec Google Sheets, et que vous souhaitez finaliser votre carte.
- Si vous avez déjà créé une clé API Google Sheets pour un modèle précédent, vous pouvez également utiliser cette clé pour un autre modèle.
-
Allez sur la console des développeurs Google à l’adresse https://console.developers.google.com/ et connectez-vous à votre compte Google. Google peut vous demander d’indiquer votre pays et d’accepter les conditions d’utilisation.
-
Cliquez sur « Créer un projet » à l’écran d’accueil, comme indiqué dans la Figure 12.31. Vous pouvez également aller dans le menu déroulant en haut à gauche pour sélectionner un projet > « Nouveau projet ».
-
Sur l’écran suivant, donnez à votre nouveau projet un nom court significatif pour vous rappeler son objectif, comme « handsondataviz ». Vous n’avez pas besoin de créer une organisation ou un dossier parent. Cliquez ensuite sur « Créer », comme indiqué dans la Figure 12.32.
-
Sur l’écran suivant, cliquez sur « + Activer les API et les services » en haut du menu, comme indiqué dans la Figure 12.33. Assurez-vous que le nom de votre nouveau projet apparaît près du haut de la page.
-
Sur l’écran suivant, saisissez « Google Sheets » dans la barre de recherche, et sélectionnez ce résultat, comme indiqué dans la Figure 12.34.
-
Sur l’écran suivant, cliquez sur le bouton « Activer » pour activer l’API Google Sheets pour votre projet, comme indiqué dans la Figure 12.35.
-
Dans le menu de gauche, cliquez sur « Informations d’identification », puis sur « + Créer des informations d’identification » et sélectionnez « Clé API », comme indiqué dans la Figure 12.36.
-
Sur l’écran suivant, la console générera votre clé API. Copiez-la, puis cliquez sur « Restreindre la clé », comme indiqué dans la Figure 12.37.
-
Dans la nouvelle fenêtre, sous « Restrictions API », choisissez le bouton radio « Restreindre la clé ». Dans le menu déroulant qui apparaît, choisissez « Google Sheets API », puis cliquez sur « Enregistrer », comme indiqué dans la Figure 12.38.
-
Dans votre code de carte Leaflet sur votre dépôt GitHub, ouvrez le fichier « google-doc-url.js », cliquez sur le symbole du crayon pour l’éditer, et collez-y votre clé API Google Sheets pour remplacer notre clé, comme indiqué dans la Figure 12.39. Veillez à ne pas effacer les guillemets simples ou le point-virgule. Faites défiler vers le bas pour « Confirmer vos modifications ».
Sécurité de votre clé API Google Sheets
Vous pourriez recevoir une notification de GitHub indiquant que vous avez une clé API exposée, mais ne vous inquiétez pas. Cette clé ne peut être utilisée qu’avec Google Sheets, vous l’avez obtenue gratuitement et vous n’avez attaché aucune information de facturation à celle-ci, donc Google ne peut pas vous facturer son utilisation.
Maintenant que vous avez appris comment créer une clé API Google Sheets à utiliser avec Leaflet Maps avec Google Sheets ou Leaflet Storymaps avec Google Sheets, dans les prochaines sections, vous en apprendrez davantage sur d’autres types de modèles de cartes Leaflet.
Découvrez plus d’articles et de ressources sur la visualisation des données sur Crawlan.com.
