Comment ajouter une carte Googlemap

Ajouter des cartes à PhpGedView

Un module additionnel a été développé pour PhpGedView (PGV) afin de permettre aux utilisateurs d'ajouter des cartes aux données de leur famille. Ce module s'appelle Googlemap, et fonctionne avec les versions PGV 3.3.8 et 4.0.x.

[Note: Cette carte additionnelle est bien distincte des petites icônes de couleur présentes sur les fiches individuelles qui permettent en cliquant dessus, d'accéder à des cartes sur différents sites web. Ces cartes sont générées à partir des renseignements de longitude et de latitude qui ont été ajoutés dans le fichier GEDCOM.]

Ce module affiche des informations supplémentaires sur les individus - voir Figure 1. Il y a un onglet supplémentaire sur la fiche de chaque individu qui présente une carte issue de Google Maps.

On peut cliquer sur chacun des marqueurs présents sur cette carte afin d'afficher les données qui sont attachées au lieu pointé par le marqueur. Si plus d'un événement s'est déroulé à l'endroit du marqueur, les événéments supplémentaires sont alors affichés dans des tableaux.

Erreur lors de la création de la miniature : Fichier manquant

Figure 1

Logiciel

Vous devrez télécharger le module "googlemap files" nécessaire à l'adresse suivante [1]

Soyez bien conscient que ce module est encore en cours de développement et peut évoluer de temps à autre.

Si vous voulez être tenu informé des dernières modifications (ainsi que des derniers développements sur l'ensemble de PhpGedView) je vous conseille de visiter régulièrement cette adresse: [2] (évidemment, c'est en anglais !)

Une fois que vous aurez téléchargé ce module, vous obtiendrez les fichiers suivants:

Figure 2

Le répertoire ‘extra’ n'est pas nécessaire: vous pouvez ou non le télécharger (les fichiers qui appartiennent à ce répertoire sont des listes de lieux que vous pouvez importer au moyen de la fonction "Editer des lieux").

Copiez la totalité des fichiers du module googlemap que venez de télécharger (avec ou sans le répertoire extra. N'oubliez pas de télécharger le fichier googlemap.php !) dans le répertoire "modules" du logiciel PhpGedView que vous avez installé. Modifiez les permissions du répertoire "modules" ainsi que celles de tous les fichiers du répertoire à ‘777’.

De plus, les fichiers suivants doivent aussi être mis à jour:

• le fichier admin.php qui se situe à la racine du répertoire de votre logiciel PhpGedView a besoin d'être mise à jour. En effet, cette nouvelle version est nécessaire afin de faire apparaître, au bas de la page d'administration du logiciel, la rubrique "configuration googlemap".
  Pour celà, allez à l'adresse http://phpgedview.svn.sourceforge.net/viewvc/phpgedview/trunk/phpGedView/
  et récupérez la dernière version de ce fichier. Téléchargez cette nouvelle version sur votre serveur (dans le répertoire d'installation de votre logiciel PhpGedView) afin de remplacer le fichier admin.php qui y était.
• le fichier lang.fr.php qui se trouve dans le répertoire 'modules/googlemap/langages' de votre logiciel PhpGedView a également besoin d'être mise à jour. En effet, cette nouvelle version est nécessaire afin de faire apparaître en français la rubrique "configuration googlemap" qui a été ajoutée par la nouvelle version du fichier admin.php que vous avez téléchargée ci-dessus.
  Pour celà, allez à l'adresse http://phpgedview.svn.sourceforge.net/viewvc/phpgedview/trunk/phpGedView/modules/googlemap/languages/

Note spéciale pour les utilisateurs de la version PGV3.3.8:  allez à la racine de répertoire d'installation de PhpGedView,
et renommez le fichier ‘individual.php’ en ‘zindividual.php’ (ou n'importe quel autre nom).
 Puis copiez le fichier ‘individual-3.3.8.php’ à la place du fichier ‘individual.php’

La clé d'enregistrement

Pour permettre une connection au serveur Google Maps, vous devz obtenir une clé d'enregistrement auprès de Google.

Allez à l'adresse suivante http://www.google.com/apis/maps/signup.html. Cette adresse correspond au site Google Map, et vous devrez vous enregistrer en tant que membre de Google pour pouvoir aller à l'étape suivante. Donc, enregistrez-vous. IL n'y a aucun danger.

Une fois que vous avez réalisé votre enregistrement, vous pouvez allors vous connecter avec votre identifiant de membre Google. Google vous demandera alors où se situe votre répertoire d'installation de PhpGedView installation, il vous faut donc rentrer l'URL (l'adresse internet) www.xxxx.yyyy.zz/place de votre répertoire PhpGedView. Choisissez un endroit de votre arborescence qui vous permettra d'utiliser votré clé d'enregistrement pour plusieurs bases de données (si tant est que vous ayez plusieurs bases de données avec votre logiciel PhpGedView).

Une fois que vous avez obtenu votre clé d'enregistrement, gardez en une copie. Sous Windows, surlignez là, faites Ctrl+C - n'essayez pas de copier la clé en recopiant chaque caractère – vous risqueriez de vous tromper! Et, par sécurité, ouvrez Notepad, copiez la clé, et sauvegardez le fichier pour plus tard (au cas où).

Commencer l'opération

Vous pouvez maintenant vous connecter en tant qu'administrateur à PhpGedView. Pendant cette opération, le module Googlemap va créer une nouvelle table (‘placelocation’) dans la base de données de votre serveur.

Le menu d'administration s'affiche alors, et en bas de la page vous verrez apparaitre un lien de configuration de Googlemap. Choisissez ‘Configuration Googlemap’. Si l'option de configuration n'apparait pas, vérifiez que vous avez bien le fichier ‘config.php’ que vous avez créé.

Erreur lors de la création de la miniature : Fichier manquant

Figure 3

Une nouvelle fenêtre s'ouvre alors:

Figure 4

Sélectionnez "Activer Googlemap" à ‘Oui’ and et copiez votre clé d'enregistrement Googlemap dans l'emplacement "Clé API Google Maps". Sauvegardez votre configuration. Vous pourrez toujours par la suite revenir à cette page de configuration de Googlemap pour modifier les autres paramètres de cette page lorsque vous aurez acquis plus d'expérience.

A ce stade, déconnectez-vous de PhpGedView. Puis connectez-vous à nouveau, et vérifiez que la page de chaque individu dispose bien d'un onglet "Carte", bien que cet onglet soit grisé en clair. Si tel n'est pas le cas, recommencez l'opération depuis le début.….mais, avant de toute recommencer depuis le début, copiez le fichier defaultconfig.php sur votre serveur, et renommez le config.php (celà signifiera que vous avez les deux fichiers config.php et defaultconfig.php dans le répertoire googlemap). Et vérifiez également la configuration de Googlemap configuration afin de vous assurer que vous n'avez pas égaré votre clé d'enregistrement...

Maintenant, revenez au sommet de la page de configuration et recommencez l'opération...

Vous êtes maintenant près à inclure les données de cartographie dans votre fichier. Avant celà, n'oubliez pas de modifier les droits à permission de votre répertoire "modules" à ‘644’.

Comment faire apparaître les cartes

L'étape suivante nécessite quelques explications.

Obtenir les coordonnées (latitude, longitude) des lieux

Les coordonnées (latitude, longitude) des lieux peuvent être obtenues de plusieurs façons.

Voici une liste non exhaustive de sites vous permettant d'obtenir ces coordonnées:

• en utilisant le logiciel Google Earth, vous explorez la planète et obtenez instantanément les coordonnées d'un lieu en pointant votre souris
• en utilisant le site de cartographie Cartes Googlemap, vous pouvez lire les coordonnées directement en parcourant les cartes
• http://www.beeloop.com/maps/flickr_geotagr.php?language=english, est un autre site qui vous permet également de parcourir les cartes de la planète et d'afficher en instantané les des lieux visités
• sur le site officiel de PhpGedView vous pouvez téléchargez les fichiers qui contiennent les coordonnées des villes de différents pays (Allemagne, Royaume Uni, Pays Bas, Etats-Unis sont les pays disponibles à la date du 20 mars 2007), et vous pouvez ensuite importer les fichiers à partir du menu de configuration de Googlemap selon la méthode décrite ci-après.

Il n'est pas inutile de vérifier les données que vous avez importées pour vérifier qu'elles respectent les conventions suivantes:

Coordonnées

Habituellement, les coordonnées sont rentrées en degrés, minutes (il y a 60 degrés dans une minute) et secondes (il y a 60 secondes dans une minute), et sont écrites selon ce format: 33° 44’ 55”. Dans la plupart des ordinateurs, vous pouvez entrer ces coordonnées sans avoir besoin de saisir les symboles ° ' " - 33 44 55, vous pouvez aussi les rentrer au format décimal: 33.7486 (pour arriver à ce format il suffit de multiplier les minutes par 60, d'ajouter les secondes, puis diviser la somme par 3600. Enfin, il faut ajouter les degrés).

Coordonnées positives et négatives: les coordonnées au Nord et à l'Est sont des nombres positifs, les coordonnées au Sud et à l'Ouest sont des nombres négatifs – ainsi -23.456 144.666 correspond à 23.456S 144.666E

Souvenez-vous que les latitudes ne peuvent pas être supérieures à +/- 90 degrés, et que les longitudes ne peuvent pas être supérieures à 180 degrés

Lieux

Les noms de lieux sont définis par ordre d'importance décroisssant, d'un point de vue géographique et sont séparés par des virgules. Ainsi, les lieux français sont classés comme suit: Pays, Région, Département, Ville. Vous n'avez besoin de rentrer un lieu particulier une seule fois lorrsque vous cliquez sur "éditer un lieu" - le logiciel PhpGedView le réutilisera autant que de besoin.

Comment ajouter un lieu en utilisant le module Googlemap de PhpGedView (méthode recommandée)

Note préliminaire: le module Google Map est conçu pour fonctionner avec des lieux qui sont décrits de manière hiérarchique, d'un pont de vue géographique, un peu comme un arbre. Si nous considérons une ville de la région parisienne, cet arbre aurait la structure suivante 'France, Ile de France, Val d'Oise, Pontoise'. Cette structure hiérarchique vous aidera ainsi à retrouver un ensemble de personnes habitant ou ayant habité la même ville. Et cette structure est conforme aux spécifications du format GEDCOM, utilisé par PhpGedView.

Et, AVANT que vous ne commenciez votre travail de cartographie des lieux de vos ancêtres, vérifiez attentivement vos données. Assurez-vous que la structure des lieux est bien correcte et respecte la structure hiérarchique, qu'il n'y a pas de doublons, que les lieux sont bien rangés dans le bon département. Alors, le module Googlemap vous affichera très facilement les cartes correspondant aux données que vous aurez entrées.

Cette fonctionnalité utilise de nouvelles tables dans votre base de données SQL pour enregistrer les noms et les coordonnées des lieux. Les lieux existants peuvent être importés et les informations relatives aux coordonnées de ces lieux peuvent être ajoutées en faisant appel aux outils graphiques (zoom/clic sur une carte) ou en entrant des coordonnées.

Les informations de localisation sont enregistrées ailleurs que dans le fichier GEDCOM (et peuvent être échangées entre des fichiers GEDCOM au format PhpGedView) et les données de localisation ne sont entrées qu'une seule fois pour un lieu donné. La restauration des données de localisation est possible par un export des nouvelles tables de la base de données SQL au format CSV. Des ajouts de données de localisation peuvent être effectués par un import de fichiers au format CSV (en respectant la structure hiérarchique exacte de description des lieux).

En utilisant la structure en arbre mentionnée plus haut, les données de localisation sont rentrées pour ce qui concerne les lieux français, en commençant par le pays, puis le région, le département et enfin la ville. En fonction des pays, cette description des localisations peut évoluer (il peut y avoir des comtés, des cantons,...). Dans tous les cas, il est impératif que cette structure soit en arbre (ou en poupées russes), en commençant par l'entité géographique la plus large (le pays) et en terminant par l'entité géographique la plus petite (la ville).

En utilisant vos droits d'administrateur, allez dans le menu d'administration et (à la fin de ce menu en bas à droite) cliquez sur "éditer les coordonnées d'un lieu". La partie supérieure gauche de l'écran ressemblera à ceci:

Le mot "Sommaire" qui apparaît sur cette fenêtre représente le niveau le plus haut de l'arbre hiérarchisé des lieux que vous utilisez dans votre logiciel. En règle générale, ce niveau le plus élevé correspond au pays, mais il pourrait correspondre à un continent si vous avez décidé de rentrer tous vos lieux sous la forme [Continent, Pays, Région, Département, Ville].

Cliquez sur 'Ajouter un lieu', et nous allons vous illustrer comment cette saisie de lieu se déroule pour le cas le plus courant où la niveau le plus élevé de l'arbre des lieux est le pays, et nous prendrons comme pays l'exemple de la France.

Une fois que l'on a cliqué sur "Ajouter un lieu", cette nouvelle fenêtre apparaît:

Erreur lors de la création de la miniature : Fichier manquant

Figure 6b

Tapez alors 'France' dans la case "lieu", cliquez sur 'Pays' dans la case "précision", puis cliquez sur "Recherche" (Nota: il faut avoir place le curseur de votre souris à l'extérieur de la boite "pays" pour que le lien "Recherche" apparaisse et puisse être cliqué).

Si vous êtes connectés à Internet, le module Googlemap de PhpGedView va alors se connecter sur le site Geonames, qui dispose de l'enregistrement de 2.2 millions de lieux différents sur la planète entière. Si le lieu que vous avez entré a été trouvé par ce site, les détails apparaîtront automatiquement sur cette fenêtre. Vous pouvez toujours visiter le site par vous-même(http://www.geonames.org/).

Ainsi, pour la France, vous voyez alors apparaître sur la carte du monde 4 repères jaunes placés sur la France, l'Ile Maurice, l'Ile de France, et l'arrondissement de Fort de France. Et en dessous de la carte, ces quatre lieux apparaissent sous forme de liens cliquables.

Erreur lors de la création de la miniature : Fichier manquant

Figure 6b

Parmi ces quatre choix de lieux qui vous sont proposés par ce site, choisissez celui qui correspond à celui que vous voulez en cliquant sur 'Utiliser cette valeur'.