Création d'une clé api google map geocoding
Définition :
Une clé API et une chaîne de caractères, comme un mot de passe, permettant de vous identifier pour accéder au serveur de Google (ici Google Map) de manière à ce que vous puissiez profiter de toute la puissance de calcul de leur serveur.
Depuis le 26 octobre 2011, à cause du besoin grandissant des utilisateurs de Google à utiliser ses services, le service de géocodage Google Map est devenu limité
(2 500 requêtes par jour).
Pourquoi une clé API ?
Pérégrination utilise les lieux tels qu'ils sont définis dans le GEDCOM. Si dans votre arbre généalogique vous ajoutez les subdivisions du lieu pour un événement donné (hameau, lieux-dit, rue, localité, emplacement...) ceci sera inscrit dans le GEDCOM comme un lieu à part entière.
Ainsi :
Roubaix, 59100, Nord, France ET Roubaix, 59100, Nord, France, Rue de l'Épeule
seront considérés comme 2 lieux différents, même si votre logiciel de généalogie les considèrent comme 1 seul et unique lieu.
Or si vous avez 2 500 lieux différents, il faut savoir que Pérégrination utilise 6 combinaisons d'orthographe différentes des subdivisions du lieu en cas d'échec de géolocalisation. Il se peut donc qu'il dépasse votre quota de 2500 requête si à chacune il y as un échec (2 500 ÷ 6 ≈ 416)
Pour géolocaliser un grand nombre de lieux (supérieur à 2 000), vous avez deux solutions :
- Souscrire à une clé API payante, il existe des clé API pour 5 000 requêtes. Pas de panique, Pérégrination peut réussir a récupérer les coordonnées sans API. Mais si cela dépasse plusieurs centaines de requêtes, cela peut signaler votre adresse IP aux serveurs de Google et bloquer l'accès aux infos sur Google Map (détection de Robots).
- Créé plusieurs clés API en créant 1 compte par clé, maximum 12 comptes soit 50 000 requêtes possible
Création d'un compte Gmail :
#1 Allez sur la page d'acceuil, cliquez sur "Connexion", puis créez un compte :
#2 Remplissez les différents champs et validez
#3 Acceptez les règles de confidentialité et conditions d'utilisation
#4 Maintenant vous voilà en possession d'un compte Gmail, ceci vous permettra d’accéder librement à tous les outils de Google
Etape 2 : Création du Projet
#1 Maintenant il faut aller sur la Console des APIs Google, une simple recherche sur Google Search vous permet d'y arriver directement
#2 Vous arrivez automatiquement sur cette page
#3 Pour créer un projet, cliquez sur "Project" et ensuite "Créer un projet"
#4 Vous pouvez changer le nom qui est ici "My Project", vous devez néanmoins cliquez sur "Non" pour éviter les pubs relatifs à Google Console API et "Oui" pour accepter les conditions d'utilisation des APIs Google, enfin cliquez sur "Créer"
#5 Après avoir cliqué sur "Créer" un cadre noir s'affiche en bas a gauche de votre écran vous informant que la création de votre projet et actuellement en cours de réalisation.
Création de la Clé API
#1 Une fois votre projet créé, vous êtes automatiquement redirigé et connecté sur votre projet. Il faut maintenant créer la clé API. Pour le programme Pérégrination, vous devez choisir une clé API "Google Maps Géocoding API", cliquez sur ">> Plus" pour afficher le reste des APIs concernant "Google Maps"
#2 Choisissez "Google Maps Geocoding API"
#3 Selon la rapidité de Google, une page de chargement s'affiche avec une barre de progression circulaire
#4 Cliquez sur "Activer"
#5 le message "ACTIVATION EN COURS..." s'affiche
#6 Ensuite cliquez sur "Créer des identifiants"
#7 Puis cliquez sur "De quels identifiants ai-je besoin ?"
#8 Automatiquement Google trouve ce dont vous avez besoin pour cette clé API et l'active, ensuite cliquez sur "OK"
#9 Vous êtes maintenant en possession d'une clé API Google Maps Géocoding (Clé API de Géolocalisation Google Map), vous voyez s'afficher un code d'une trentaine de caractères
#10 En cliquant sur l'onglet "Tableau de bord" vous pouvez obtenir les statistiques de son utilisation, ceci vous permettra de savoir le nombre de requêtes que vous avez réalisées avec cette clé, si vous lavez dépassé le quota, etc...
#11 Vous pouvez donc l'utiliser dans Pérégrination avec un simple copier-collez
#12 Puis une fois que Pérégrination aura enregistré votre clef, il l'utilisera pour le géocodage
#13 Une fois le géocodage terminé, vous pouvez obtenir les statistiques de votre clef en temps réel sur votre Tableau de Bord via la Google Console
#14 Cliquez sur les traits horizontaux a côté de "GoogleAPIs" et cliquez sur "IAM et admin" , cliquez sur "Tout les projets" et vous pourrez voir en temps réel les statistiques de votre clé
