DECOUVERTE DE MAPSERVER

Philippe LPINARD

Page 1

20/12/2008

Sommaire
A. Prambule ........................................................................... 3 1) Dfinitions.......................................................................... 3 2) Configuration matrielle .................................................... 4 3) Configuration logicielle ..................................................... 4 4) Un petit schma pour comprendre les mcanismes ........... 5 5) Quelques remarques avant de dbuter ............................... 5 B. Installer et tester MS4W.................................................... 6 C. Cration de Mapfiles ........................................................ 23 ANNEXE 1 Solution de lexercice ....................................... 28 ANNEXE 2 Insrer des tiquettes ....................................... 29 ANNEXE 2 Liens................................................................... 30

Philippe LPINARD

Page 2

20/12/2008

A. Prambule
Ce didacticiel trs simple vous prsentera les fonctionnalits les plus basiques de Mapserver et MS4W. Vous apprendrez installer ce serveur cartographique dans un environnement Windows puis le tester avec le tutoriel officiel. Enfin, vous crerez votre propre Mapfile ( la main !) partir dun Shapefile afin de le visualiser dans votre navigateur Internet. 1) Dfinitions
Mapserver : est un environnement de dveloppement Open Source permettant de construire des applications internet rfrence spatiale. MapServer n'est pas un SIG complet, et n'aspire pas le devenir. MapServer excelle afficher vos donnes spatiales sur le web (cartes, images, et donnes vectorielles).En plus de pouvoir parcourir des donnes gographiques, MapServer vous permet de crer des "cartes interactives", c'est--dire, des cartes qui peuvent guider l'utilisateur vers un contenu. Par exemple, la Minnesota DNR Recreation Compass offre aux utilisateurs un accs vers plus de 10,000 pages web, rapports et cartes travers une simple application. Le mme outil sert comme "moteur cartographique" pour d'autres parties du site, fournissant une information gorfrence quand c'est utile. MapServer a t dvelopp par la University of Minnesota (UMN) dans le cadre du projet ForNet en coopration avec la NASA et le Minnesota Department of Natural Resources (MNDNR). A ce jour, le projet MapServer est hberg par le projet TerraSIP , un projet sponsoris par la NASA, et ralis par UMN et un groupement d'acteurs dans le domaine de l'amnagement du territoire. Le logiciel est maintenu par un nombre grandissant de dveloppeurs (approximativement 20) rpartis dans le monde entier. Il est soutenu par un groupe htrogne d'organisations qui financent les dveloppements et la maintenance. MS4W : est un paquetage fourni gratuitement par DM-solutions. Il regroupe les binaires prcompils de lensemble des composants ncessaire pour installer un service web bas sur le serveur Apache, le langage PHP ainsi que MapServer. Son installation est vraiment trs simple. Mapfile : est le fichier de configuration de votre carte lisible par MapServer. Il possde une structure en sections et une syntaxe spcifique. Il souvre, se cr et se modifie avec le Notepad. Shapefile : ou "fichier de formes" est un format de fichier issu du monde des Systmes d'Informations Gographiques (ou SIG). Initialement dvelopp par ESRI pour ses logiciels commerciaux, ce format est dsormais devenu un standard de facto, et largement utilis par un grand nombre de logiciels libres (MapServer, Grass, Udig, MapGuide OpenSource ...) comme propritaires. Vous pouvez tlcharger sur mon site mon didacticiel spcifique ce format. Il contient toute l'information lie la gomtrie des objets dcrits, qui peuvent tre : des points des lignes des polygones

Philippe LPINARD

Page 3

20/12/2008

Son extension est classiquement SHP, et il est toujours accompagn de deux autres fichiers de mme nom, et d'extensions : DBF, qui contient les donnes attributaires relatives aux objets contenus dans le Shapefile SHX, qui stocke l'index de la gomtrie D'autres fichiers peuvent tre galement fournis : .sbn et .sbx - index spatial des formes. .fbn et .fbx - index spatial des formes pour les Shapefile en lecture seule .ain et .aih - index des attibuts des champs actifs dans une table ou dans une table d'attributs du thme. .prj - information sur le systme de coordonnes, utilisant le format WKT (Well Known Text). .shp.xml - mtadonnes du Shapefile. .atx - fichier d'index des attributs pour le fichier dbf, sous la forme <shapefile>.<nom_de_la_colonne>.atx (ArcGIS 8 et suivants)

Apache : Le logiciel Apache HTTP Server, souvent appel Apache, est un serveur HTTP produit par la Apache Software Foundation. C'est le serveur HTTP le plus populaire du World Wide Web. C'est un logiciel libre avec un type spcifique de licence, nomme licence Apache.

Les dfinitions proviennent de

et Des diffrents sites des logiciels

2) Configuration matrielle
1 PC dual-core 2,8Ghz avec 2Go de RAM et une carte vido GeForce 7950 512Mo. 1 PC Portable 1,6Ghz avec 1Go de RAM et une carte vido GeForceGo 7400 256 Mo.

3) Configuration logicielle Windows XP pro SP2 MS4W 2.2.4

Philippe LPINARD

Page 4

20/12/2008

4) Un petit schma pour comprendre les mcanismes

5) Quelques remarques avant de dbuter

Ce didacticiel est destin aux futurs utilisateurs de MapServer, linstallation est explique. Toutefois, vous devez connatre un minimum le format Shapefile et avoir les droits Administrateur dans Windows.

Lets play now !

Licence libre Creative Commons Paternit Pas dutilisation commerciale Partage dans les conditions initiales au fichier original http://creativecommons.org/licenses/by-nc-sa/2.0/fr/

Philippe LPINARD

Page 5

20/12/2008

B.

Installer et tester MS4W

Linstallation de MapServer grce au package MS4W (MapServer for Windows !) est vraiment dune simplicit enfantine. Dans ce chapitre je vous explique le tlchargement des donnes, linstallation des logiciels et le premier lancement de MapServer avec un navigateur Internet. Etape 1
Allez sur le site www.maptools.org/ms4w/

Descendez en bas de la page et cliquez sur le lien MS4W downloads page .

Philippe LPINARD

Page 6

20/12/2008

Cliquez sur la version la plus rcente du package pour dbuter le tlchargement.

Cliquez sur Enregistrer .

Philippe LPINARD

Page 7

20/12/2008

Choisissez le rpertoire o stocker le fichier puis cliquez sur Enregistrer . Remarque : mme si linstallation de MapServer va se faire sous la racine de votre disque dur systme, je vous conseille pour linstant denregistrer ce package dans un dossier temporaire. Effectivement, vous allez tlcharger plusieurs fichiers et il faudra dabord prparer le dossier final avant de le dposer lendroit dfinitif.

Retournez sur la page des tlchargements de MS4W puis cliquez sur la dernire version de lditeur de Mapfile MapLab).

Cliquez sur Enregistrer .

Philippe LPINARD

Page 8

20/12/2008

Choisissez le mme rpertoire que celui du premier tlchargement puis cliquez sur Enregistrer .

Rejoignez maintenant le site officiel de MapServer puis cliquez sur Documentation . http://mapserver.gis.umn.edu/

Philippe LPINARD

Page 9

20/12/2008

Choisissez MapServer 4.X tutorial .

Cliquez sur le lien MapServer 4.X tutorial dans cette nouvelle page.

Philippe LPINARD

Page 10

20/12/2008

Cliquez sur le lien http://biometry.gis.umn.edu/tutorial/.

Choisissez le lien Go to the tutorial si vous voulez le suivre en ligne.

Philippe LPINARD

Page 11

20/12/2008

La premire page du didacticiel en ligne souvre alors.

Ou prfrez, comme moi, lavoir demeure sur mon disque dur en cliquant sur Other Ressources .

En bas de la page cliquez sur Download the tutorial .

Philippe LPINARD

Page 12

20/12/2008

Cliquez sur Tutorial.zip .

Cliquez sur Enregistrer .

Choisissez le mme rpertoire que les deux autres fichiers puis cliquez sur Enregistrer .

Philippe LPINARD

Page 13

20/12/2008

Vous pouvez vrifier que les 3 fichiers sont bien dans votre dossier temporaire.

Etape 2
Maintenant que vous avez rcuprer tous les fichiers ncessaires, vous allez constituer votre dossier final que vous dposerai simplement la racine de votre Disque Dur. Dcompressez les 3 archives dans votre dossier temporaire.

Philippe LPINARD

Page 14

20/12/2008

Ouvrez le dossier ms4w_2.2.4 . Vous pouvez voir le dossier quil vous faudra dplacer lorsque vous aurez intgrer lintrieur les donnes des deux autres dossiers.

Voici lintrieur du dossier MS4W .

Si vous ouvrez les deux autres dossiers cte cte, vous constatez que tous possdent des noms de dossiers communs. Il vous suffit donc de prendre les fichiers des diffrents sous-dossiers de MapLab et du tutoriel et de les dposs directement dans les dossiers et sous-dossiers portant les mmes noms dans le dossier MS4W. Vous pouvez visualiser quelques captures dcran de sous-dossiers MS4W avec les fichiers ajouts des deux autres modules. Le sous-dossier htdocs du sous-dossier Apache de MS4W.

Philippe LPINARD

Page 15

20/12/2008

Le sous-dossier apps de MS4W

Le sous-dossier ms-temp du sous-dossier tmp de MS4W.

Votre dossier qui se nomme MS4W tant complet et prt, vous pouvez maintenant le dplacer la racine de votre disque dur systme. Coupez-le.

Philippe LPINARD

Page 16

20/12/2008

Puis collez-le.

La commande de dplacement sexcute.

Votre dossier MS4W se trouve maintenant au bon endroit.

Philippe LPINARD

Page 17

20/12/2008

Etape 3
Il faut prsent installer et dmarrer le serveur Apache. Ouvrez le dossier MS4W.

Double-cliquez sur apache-install.bat .

Philippe LPINARD

Page 18

20/12/2008

Une fentre va souvrir et se refermer rapidement. Vous pouvez aussi lancer cet excutable avec une Invite de Commande pour visualiser la procdure sans que la fentre se ferme automatiquement. Vous constatez que jai supprim tout dabord une ancienne version dApache, puis jai install celle du package MS4W. Le petit message derreur nest pas important.

Double-cliquez sur licne ApacheMonitor.exe du sous-dossier Bin du dossier Apache .

Dans la barre des taches de Windows, vous voyez licne de la console Apache.

Philippe LPINARD

Page 19

20/12/2008

Cliquez gauche sur licne et choisissez Apache MS4W Web Server puis Start .

Une petite flche verte vers la droite vous indique que le serveur web sest lanc correctement.

Etape 4
Il ne nous reste plus qu vrifier le bon fonctionnement du serveur web et de confirmer la prsence des deux composants optionnels : MapLab et le tutoriel officiel. Ouvrez votre navigateur Internet comme dhabitude.

Philippe LPINARD

Page 20

20/12/2008

Dans la barre dadresse, tapez Localhost puis la touche ENTER .

Descendez en bas de la page et vrifiez que le composant MapLab est bien prsent.

Philippe LPINARD

Page 21

20/12/2008

Tapez ensuite ladresse URL du premier exemple du tutorial de MapServer :

http://localhost/cgi-bin/mapserv.exe?map=/ms4w/apps/tutorial/htdocs/example1-1.map&layer=states&mode=map

Appuyez sur la touche ENTER de votre clavier. Remarque : si vous avez un second PC connect en rseau local, vous pouvez trs bien tester la procdure sur ce dernier en remplaant Localhost par ladresse IP de celui o est install MapServer. Gnial ! En local

Ou en rseau !

Flicitations, vous avez visualis votre premier Mapfile grce votre serveur cartographique MapServer !

Philippe LPINARD

Page 22

20/12/2008

C. Cration de Mapfiles
Dans cet exercice, vous allez apprendre crer des fichiers de configuration Mapfiles. Ce dernier se chargera de la conversion dun de vos Shapefile en fichier image PNG lisible par nimporte quel navigateur Internet. Etape 1
Pour que les chemins des rpertoires soient identiques, je vous propose de placer votre Shapefile des dpartements Franais au mme endroit que ceux du didacticiel officiel, c'est--dire dans le dossier suivant : C:\ms4w\apps\tutorial\data\.

Etape 2
Avant de crer votre Mapfile, vous devez connatre les limites de ce dernier. Je vous proposerais bien de les trouver grce ArcCatalog dArcGis mais comme nous utilisons MapServer qui est un logiciel libre, vous allez dterminer ces limites grce un petit utilitaire libre (ogcinfo) en ligne de commande. Afin de faciliter le travail, vous allez dplacer temporairement votre Shapefile (avec tous ses fichiers) ainsi que lutilitaire dans le rpertoire suivant :
C:\ms4w\Apache\cgi-bin\.

Remarque : ogrinfo se trouve dans le dossier C:\ms4w\tools\gdal-ogr .

Philippe LPINARD

Page 23

20/12/2008

Ouvrez une invite de commande et dplacez-vous vers le dossier prcdent (Vous trouverez toutes les commandes utiliser pour vous dplacez dun rpertoire un autre sur les captures dcran).

Tapez la commande suivante (sans les symboles du dollar !) : $ ogrinfo al so departements_france_II.shp $.

Philippe LPINARD

Page 24

20/12/2008

Appuyez sur la touch ENTER et reprez les valeurs EXTEND . Si vous le souhaitez, vous pouvez maintenant supprimer votre Shapefile du dossier cgi-bin dApache.

Etape 3
Vous avez maintenant toutes les informations ncessaires la cration de votre premier Mapfile. Ouvrez le Notepad (bloc-notes) et recopiez le texte de limage suivante. Remarque : vous pouvez bien entendu modifier les couleurs et tester la procdure avec vos propres Shapefiles !

Philippe LPINARD

Page 25

20/12/2008

Tapez enfin lURL de votre Mapfile dans votre navigateur Internet.

http://localhost/cgibin/mapserv.exe?map=/ms4w/apps/tutorial/htdocs/premier_mapfile.map&layer=departements_france_II&mode=map

Votre Shapefile a bien t converti en image PNG.

Etape 4
Pour terminer cette dcouverte de MapServer, je vous propose de crer un autre Mapfile mais avec deux couches cette fois-ci. Copiez les deux Shapefiles communes et forets disponibles sur mon site dans le dossier C:\ms4w\apps\tutorial\data\. Ouvrez le Notepad (bloc-notes) et recopiez le texte de limage suivante.

Philippe LPINARD

Page 26

20/12/2008

Tapez enfin lURL de votre Mapfile dans votre navigateur Internet.

http://localhost/cgibin/mapserv.exe?map=/ms4w/apps/tutorial/htdocs/second_mapfile.map&layer=forets&layer=communes&mode=map

Vos deux Shapefiles ont bien t convertis en image PNG.

Etape 5
Comme vous tes des connaisseurs maintenant, vous avez certainement remarqu que les limites des communes ntaient pas prsentes, nest ce pas ? Grce aux deux exemples prcdents, essayez de trouver la solution. Lannexe 1 pourra toujours vous aider A bientt.

Philippe LPINARD

Page 27

20/12/2008

ANNEXE 1 Solution de lexercice

Etape 1
Ouvrez et modifiez votre MapFile en ajoutant la ligne en surbrillance de limage suivante. Vous laurez compris, vous indiquez la couleur des contours (limites) des communes.

Etape 2
Visualisez votre MapFile aprs avoir actualiser votre navigateur. Les limites des communes apparaissent.

Philippe LPINARD

Page 28

20/12/2008

ANNEXE 2 Insrer des tiquettes

Etape 1
Vous souhaitez ajouter les noms des communes votre Mapfile ? Aucun problme, ouvrez et modifiez votre MapFile en ajoutant les lignes de limage suivante.

Etape 2
Visualisez votre MapFile aprs avoir actualiser votre navigateur. Les noms des communes apparaissent.

Philippe LPINARD

Page 29

20/12/2008

ANNEXE 2 Liens
Quelques liens pour complter ce didacticiel :
Des sites sur MapServer Le site officiel Le site de MS4W mapserver.gis.umn.edu/ www.maptools.org/ms4w/

Merci davoir lu et utilis mon didacticiel A bientt pour de nouvelles aventures sigistes Philippe LPINARD Pilote instructeur hlicoptre Formateur SIG Passionn de gomatique !

www.sig-gps.net

Philippe LPINARD

Page 30

20/12/2008