Kit d'utilisation de l'API Google Maps
Contenu de la boîte à outils
Ce kit de développement comporte 5 fichiers :
- /cartes/config_inc.php : Fichier de paramétrage à modifier en tout premier lieu
- /cartes/parser.php : Permet de générer des flux xml à partir de fichiers de données
- /cartes/maps.php : Affiche les données géo-référencées d'un flux rss sur une carte Google Maps
- /cartes/geoloc.php : Retrouve les données géo-localisées de toutes les adresses postales d'un fichier
- /rss/aec.xml : Fichier exemple utilisé lorsqu'aucune autre carte n'est disponible
Vous pouvez télécharger le kit complet en cliquant ici :
toolbox.zip
Pré-requis
Afin de pouvoir utiliser ces utilitaires, vous devez disposer d'un serveur Web (Apache ou IIS par exemple) et le module d'interpretation PHP doit être activé.
Vous devez également disposer d'une clé Google Maps. Pour cela, rendez vous à l'adresse http://www.google.fr/apis/maps/signup.html et remplissez le formulaire situé au bas de la page.
La clé générée devra ensuite être copiée dans le fichier de configuration livré avec cette boîte à outils (cf. étape 4 de l'installation).
Installer la boîte à outils
L'installation du kit est très simple et peut-être réalisée en 4 étapes :
-
Téléchargement
A l'aide du lien ci-dessus, téléchargez le kit sur votre ordinateur.
-
Décompression des fichiers de l'archive
Décompressez l'archive à l'aide d'un outil adapté (Winzip, Winrar, Quickzip, 7-zip, etc.).
-
Copie des fichiers sur le serveur
Copiez le répertoire décompressé à la racine de votre serveur web ou dans un de ses sous-répertoires.
-
Modifier le fichier de paramétrage confing_inc.php
Ce fichier vous permettra d'adapter l'utilisation du kit à votre environnement. Chaque ligne est documentée et permet d'affiner l'utilisation de chaque paramètre.
Vous avez la possibilité de déplacer manuellement ou renommer les répertoires de l'application. Dans ce cas, ces modifications doivent être répercutées dans le fichier de configuration.
Attention : avant toute manipulation de ce fichier, nous vous recommandons d'en faire une copie de manière à pouvoir revenir en arrière en cas d'erreur.
Utiliser la boîte à outils
Trois outils sont mis à votre disposition :
-
Geoloc.php : permet de retrouver les coordonnées géo-localisées (Longitude et Latitude) d'adresses postales. la pertinence du résultat dépend de la qualité de l'information qui est transmise au programme.
Pour utiliser cette application, suivez le pas-à-pas qui s'affiche à l'écran lorsque vous vous rendez sur cette page.
-
parser.php : A partir d'un tableau de données, l'application génère deux flux xml. Le premier, au format geoRSS, commence à s'imposer comme l'un des standards pour la cartographie. Quant au second, il est dans un format propre à Google ce qui lui permet d'être interprété directement depuis la page d'accueil de GoogleMaps.
Pour utiliser cette application, suivez le pas-à-pas qui s'affiche à l'écran lorsque vous vous rendez sur cette page.
-
maps.php : cette page affiche affiche sur votre site les flux GeoRss générés par parser.php (cf. le pas à pas lors de la génération).
Afficher une carte : utilisez l'url http://mon_site/répertoire_de_l_application/maps.php?map=ma_carte (où ma_carte correspond au fichier ma_carte_georss.xml contenu dans le répertoire /rss/)
Clause de non responsabilité
Cette application est mise en place à titre d’expérimentation.
Aquitaine Europe Communication ne s’engage en aucun cas sur la fiabilité, la précision et la qualité des résultats qui seront générés.
Aquitaine Europe Communication ne pourra être tenu pour responsable de tout préjudice, direct ou indirect qui pourrait être occasionné par l’utilisation de la présente application.