Comment ajouter une carte Googlemap
Sommaire
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.
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:
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éé.
Une nouvelle fenêtre s'ouvre alors:
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. Voir Section Technique pour comprendre comment le module Googlemap gère les données de lieux.
