Pérégrination a été testé pour le moment avec des fichiers GEDCOM issus de Hérédis. Toutefois, rien n'exclut le fait que des GEDCOMs d'autre logiciel peuvent fonctionner. Aussi, il est important que les lieux soient correctement formatés de manière à reconnaître chacune des parties administratives. Sans quoi, il sera impossible pour mon logiciel de géolocalisé les lieux.
Le format du fichier doit être au format ANSI et non UTF8 de manière à ce que les caractères accentués puissent être encodés correctement.
Pérégrination procède en 4 étapes :
- Lecture du fichier GEDCOM avec gedcompy
- Extraction de tout les individus
- Extraction de toute les familles
- Extraction de tout les lieux
Une fois terminé, un message apparat avec le temps calculé
La seconde étape consiste à renseigner le type administratif de chaque localité.
Une fenêtre affiche les 10 premières localités où les différents champs apparaissent dans les différentes colonnes.
Pérégrination s'adapte à n'importe quelle situation, il affichera autant de colonnes qu'il y a de subdivisions.
Une étiquette affiche alors l'ordre par défaut. Si ce dernier n'est pas bon, vous pouvez les modifier via les panneaux déroulants.
Vous avez le choix avec :
- "Commune"
- "Code Postal"
- "Departement"
- "Region"
- "Pays"
- "Subdivision"
- "Ignorer"
(Pour des raisons de compatibilité d'encodage des caractères j'ai omis les accents)
Une fois vos choix enregistrer, une étiquette s'affiche sous les menus déroulant avec la sélection que vous avez validé. Vous pouvez à tout moment changer vos choix. Une fois que tout est vérifié, vous pouvez cliquez sur "Valider"
Si vous cliquez sur le bouton "Quitter" , vous quitterais la fenêtre du gestionnaire. L'étape n° 3 restera inactive.
Ce message s'affiche ensuite pour valider définitivement vos choix. Ceci active le bouton pour l'étape n° 3. Si vous cliquez sur "Non" vous reviendrez sur le gestionnaire des subdivision.
C'est le cœur du programme, c'est lui qui va déterminé automatiquement les coordonnées GPS de chacun de vos lieux. Plusieurs options sont disponible comme l'utilisation de clé API GoogleMap disponible dans le programme ou via votre propre clé API GoogleMap Geocoding
Pour gagner un temps précieux, Pérégrination permet de charger un fichier de Lieux qu'il à lui même déjà créé auparavant, et éviter de recommencer la recherche des lieux. Après avoir cliquez sur "Etape 3: Recherche des coordonnées GPS", ce message apparaît :
Si vous avez cliqué sur "Oui", une boite de dialogue apparaît et vous aide à parcourir dans vos dossiers pour retrouver le fichier CSV. Par défaut , le dossier et celui ou le programme se trouve. Néanmoins il garde en mémoire l'emplacement du dernier fichier ouvert (même après fermeture du programme).
Un fichier de Lieux et un fichier CSV (séparateur virgule) contenant :
- La première colonne pour les noms des lieux du GEDCOM
- Les Latitudes
- Les Longitudes
Une fois que les lieux sont chargé, le bouton pour l'étape n° 4 s'active.
Vous avez cliquez sur "Non" car c'est la première fois que vous allez géolocalisé les lieux de votre fichier GEDCOM. Pérégrination est compatible avec la technologie de Google Map, et vous propose d'utilisé ce que l'ont appelle les clefs API.
Une clef API et une chaîne de caractère, 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 à utilisé ses services, le service de géocodage Google Map et devenus limité (2500 reqêtes par jour).
Pérégrination utilise les lieux tel qu'ils sont définis dans le GEDCOM. Si dans votre arbre généalogique vous ajouté les subdivision du lieux 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'Epeule
seront considéré comme 2 lieux différents, même si dans votre logiciel de généalogie, il les considérera comme 1
seul et unique lieu.
Or si vous avez 2500 Lieux différents, il faut savoir que Pérégrination utilise 6 combinaison d'orthographe différente des subdivision du lieux en cas d'échec de géolocalisation. Il se peut donc qu'il
Pour géolocalisé un grand nombre de lieux (supérieur à 2000) Vous avez deux solution :
- Souscrire à une clef API payante, il existe des clef API pour 5000 a mais pas de panique, Pérégrination peut réussir à récupéré les coordonnées sans API, mais si cela dépasse plusieurs centaine de requête, cela peut signaler votre adresse IP aux serveur de google et bloqué l'accès au info sur GoogleMap (détection de Robots)
Vous avez cliquez sur "Oui", dans ce cas Pérégrination affiche une fenêtre pour vous permettre de mettre votre propre clef API Google Map
Copier votre clef API (CTRL+C) puis cliquez dans la case blanche pour placer votre curseur et coller la clef (CTRL+V) ensuite appuyeZ sur le bouton "Valider".
- Si la case et vide ce message d'erreur apparaîtra, vous retournerais directement sur CETTE FENËTRE.
- Si le champ et bien rempli, un message apparaîtra pour valider votre choix.
-
* Cliquez sur "Oui" pour valider pour enregistré votre clef.- En cas d'erreur, vous pouvez cliquez sur "Non", vous reviendrais sur la fenêtre pour corrigé votre erreur.
Note : Cas particulier, si vous validé une clef API qui n'est pas bonne ou mal orthographié, la clef API ne fonctionnera pas lors du géocodage, et sera remplacer par l'une des 40 APIs disponibles dans le code source du programme.
Si vous avez cliquez sur "Non" un autre message apparaît :
Lorsque vous cliquez sur "Oui", Pérégrination vous ouvre automatiquement 3 fenêtres via votre navigateur par défault, pour vous permettre de créé :
- Un compte Gmail
- De lire la documentation concernant les clé API de Google Map
- De créé un projet et une clef API Google Map via la "Console des API Google"
Une fois que vous avez votre clef API, vous pouvez la copier coller dans la fenêtre (voir Clef API Google Map - OUI :)
Vous avez cliquez sur "Non", un nouveau message apparaît vous informant que vous allais être redirigé pour enregistré le fichier CSV.
Dans la boite de dialogue écrivez le nom du fichier que vous souhaiter donner au fichier de Lieux, les résultat du géocodage seront automatiquement sauvegarder dans ce fichier, que vous pourrais utilisé lors de prochaine réalisations. Si vous cliquez sur annuler vous reviendrez sur la fenêtre de Pérégrination, sinon le géocodage se met en marche.
.
Tout ce fait de manière automatisé, vous n'avez plus qu'as patienté...
Voici comment procède pérégrination dans son analyse des lieux :
Pour évité toute mauvaise surprise, car la géolocalisation n'est pas une science exacte, Pérégrination est doté d'un visualiseur. Chaque couple de coordonnées (Latitudes et Longitudes) vont être groupé avec leur lieux correspondants. Ainsi si un lieu A et un lieu B ont les même coordonnées, ils seront regroupé ensemble.
Ensuite ont télécharges les images de OpenStreetMap pour chacune des coordonnées retrouvé, de manière à se que l'ont puisse visualisé sur une carte vers quoi les coordonnées pointes.
Enfin, effet, malgré toutes les méthodes mises en œuvre pour vérifier chaque résultat durant la recherche des coordonnées, nous sommes jamais à l'abri d'une erreur, surtout si les lieux rechercher sont orthographié selon leurs anciennes orthographes ou parce que ces derniers ont changé de nom, fusionné, divisé ou disparu.
Une fois les lieux géolocalisé, le visualiseur s'ouvre.
- Les différents lieux correspondants aux mêmes coordonnée retrouvé sont situé dans un cadre après le titre
- L'image de la carte avec un point coloré central qui situe l'emplacement exact des coordonnées
- La carte permet d'accéder directement à la position GPS sur Google Map via votre navigateur par défaut
- Le panneau de Control sur la droite:
-
* Avec le numéro du lieux- Les touches directionnelles:
-
* ">" pour aller à l'image suivante- "<" pour revenir à l'image précédente
- "+" pour accéder a la position GPS sur une carte Google Map via votre navigateur par défaut
- suivis par les étiquette indiquant les coordonnées Latitude et Longitude du lieu
- Les champs pour modifier les coordonnées:
-
* Champs "Latitude" et "Longitude" :-
* Il y à un contrôle des caractère, si il y a la présence d'un autre caractère que : "+-1234567890.", la chaîne de caractère sera automatiquement refusé - Bouton "Mettre à jour les coordonnées GPS pour ce lieux":
-
* Les coordonnées sont automatiquement changé dans le fichier CSV ainsi que dans les donnée en mémoire- La carte est télécharger de nouveau et réactualisé dans la fenêtre
-
- Bouton "Quitter" qui ferme automatiquement la fenêtre et active le bouton pour l'étape n°4
- Il s'agit d'un simple moteur de recherche, inscrive n'importe quelle chaîne de caractère (avec ou sans accent avec ou sans majuscules, mixte,...) il vous trouvera tout les individu qui possèdent cette chaîne de caractère dans leur Nom et Prénoms, choisissez soit l'ascendance, ou la descendance et validez.
- Si vous cliquez sur "Quitter" vous reviendrais au départ, cliquez sur "Validez" et le bouton de l'étape 5 s'activera.
- Si vous ne sélectionné pas de personnes ni de sens de direction (Ascendance/Descendance vous aurai un message d'erreur
Suivent les options d'affichage, ils s'agit des données que vous souhaiterais voir apparaître dans les fenêtres Pop-up de la carte lorsque vous cliquez sur une trajectoire, ou sur le repère d'une ville.
- "Nombre de °,x,+" affiche le nombre de Naissance de Décès et de Mariage qui s'est produit dans le lieu
- "Nombre total d'événement" : Affiche la somme de tout les événement de la ville (Naissance, mariage, décès ...)
- "Départ(s)" : Indique les individus qui sont partie, ayant eu une descendance dans un lieu différent que leur lieu de naissance
- "Arrivée(s)" : Indique les individus qui sont arrivé, ayant une ville de naissance différente de celle de leur enfant
- "Nom(s)" : Liste des patronyme ayant eu un événement avec ce lieu
- "Date extrêmes" : Comme écrit, il d'agit d'afficher la date du plus ancien et du plus récent événement produit dans cette localité
- "Valider" : Valide la sélection
Pour utilisé ces option vous devez préalablement télécharger les fichier SHAPEFILE correspondant au différents pays des villes géolocalisé
Attention ! Plus la généalogie contiendra d'individu, en fonction du nombre d'options que vous avez choisis de faire afficher, les bulles seront proportionnellement rempli en fonction du niveau géographique du regroupement, ^référer un regroupement par commune si les adresse sont nombreuse, et les individu peu nombreux, un regroupement par département, si les individu ne sont pas concentré etc... Toutes les combinaison sont possible.
Si vous cliquez sur "Passer" L'ascendance (ou la descendance) du personnage choisis et créé et la carte et réalisé sous la forme d'un fichier HTML dans vos dossier. Deux modèle de carte sont créé, un modèle type "Relief" et un modèle type "Routier", ses deux dernier se complémentent l'une étant plus détaillé que l'autre.
