1. MapFile Reference - MapServer 3.

Table of Contents de leurs propres attributs (nom de colonne .dbf)

en majuscules, et pour PostGIS, TOUJOURS en
Référence MapFile minuscules.
Notes • Les expressions régulières sous MapServer
Objet Map sont utilisées à travers la bibliothèque C de
Objet Label votre système d'exploitation. Pour plus
Objet Layer d'informations sur les expressions régulières sur
Objet Class votre système vous devriez lire la
Objet de fonction (Feature) documentation disponible avec la bibliothèque
Objet de légende (Legend) C. Sur Linux il s'agit de la glibC et vous pouvez
QueryMap Object lire la page "man 7 regex" ... Cette man page est
Objet de jointure (Join) aussi disponible sous différents UNIX. Comme
Objet de carte de référence ces RegEx sont conformes à POSIX, elles
Objet barre d'échelle (Scalebar) devraient être identiques sous Windows, aussi
Objet Web les utilisateurs Windows peuvent essayer de
Objet Projection rechercher sur INTERNET "man 7 regex"
Objet OutputFormat puisque plusieurs man pages y sont disponibles.
Référence de la symbologie
Notes Objet Map
Syntaxe
Exemples Définit l'objet maître du fichier MapFile, ainsi cet objet
racine détient tous les autres objets. Il définit les
Référence MapFile paramètres généraux de l'application/la carte.

Les MapFiles constituent le mécanisme de base pour DEBUG

configurer Mapserver. Tout élément associé avec une Permet la mise au point de l'objet map. Les
application particulière est défini ici, même si quelques sorties sont dirigées vers la sortie standard
options peuvent être modifiées via un formulaire oueb d'erreur (STDERR) ou vers le fichier de trace de
(variables CGI). MapServer s'il est indiqué dans le paramètre
LOG de l'objet WEB.
Notes EXTENT [minx] [miny] [maxx] [maxy]
L'étendue géographique de la carte à créer. Le
• Le Mapfile N'EST PAS sensible à la casse. plus souvent vous voudrez la spécifier, mais
MapServer pourra l'extrapoler si vous ne la
• Les chaînes de caractères contenant des
spécifiez pas.
caractères non alphanumériques ou un mot clé
FONTSET [filename]
de MapServer DOIVENT être placées entre
Nom complet du fichier de police de caractères
guillemet. Il est recommandé de placer TOUTES
à utiliser.
les chaînes de caractères entre double
IMAGECOLOR [r] [g] [b]
apostrophe (double-quotes).
Couleur dans laquelle la carte doit être initialisée
• Le nombre maximum de couches d'un mapfile
(la couleur d'arrière plan).
est limité à 50. Ceci peut être changé en IMAGEQUALITY [int]
modifiant la valeur de MS_MAXLAYERS du Qualité de compression pour les sorties JPEG.
fichier map.h pour spécifier le nombre souhaité Ce mot clé est maintenant délaissé au profit de
et en recompilant. l'option FORMATOPTION "QUALITY=n" dans la
• Les chemins de fichier peuvent être donnés en déclaration OUTPUTFORMAT.
valeur absolue, ou en valeur relative à la IMAGETYPE [gif|png|jpeg|wbmp|gtiff|swf|userdefined]
localisation du mapfile. De plus, les fichiers de Format de sortie à générer. Voir les détails de la
données doivent être spécifiés relativement au partie OUTPUTFORMAT en particulier pour les
SHAPEPATH formats disponibles. Le nom indiqué ici doit
• Le mapfile a une structure hiérarchisée, avec correspondre au nom ('NAME') de la définition
l'objet Map constituant la racine de utilisateur ou interne générée dans la partie
l'arborescence ("root"). Tous les autres objets OUTPUTFORMAT.
sont donc rattachés à celui-ci. INTERLACE [on|off]
• Les commentaires sont indiqués par le Les images doivent-elles être entrelacées?
caractère #. Valeur par défaut "oui" [on]. Ce mot clé est
• Les attributs sont désignés en utilisant la maintenant délaissé au profit de l'option
syntaxe suivante: [ATTRIBUTENAME] ... Notez FORMATOPTION "INTERLACE=ON" de la
que le nom de l'attribut contenu entre les déclaration OUTPUTFORMAT.
crochets EST sensible à la casse. LAYER
Généralement les fichiers shape ESRI disposent
1
 Signale le début d'un objet LAYER. NdT : Objet Label
LAYER veut dire littéralement couche, il s'agit
d'une technique de tracé de dessin dans Cet objet est utilisé pour définir une étiquette, qui est
laquelle chaque objet graphique est regroupé habituellement utilisée pour annoter un élément par du
avec des objets similaires et de même type. Par texte. Les étiquettes peuvent aussi être utilisées comme
exemple, pour une carte routière, on regroupera symboles en employant les différentes polices de
les autoroutes, qui sont du même type (ligne), caractères TrueType.
selon leur appartenance à une catégorie
(autoroute, route nationale, route ANGLE [double]
départementale, etc.). Angle, donné en degrés, pour dessiner
LEGEND l'étiquette ou AUTO pour permettre au logiciel
Signale le début d'un objet de légende de calculer l'angle , AUTO est valide seulement
(LEGEND). pour les couches de type ligne (LINE).
NAME [name] ANTIALIAS [true|false]
Préfixe lié à la carte, les noms des fichier GIF Le texte doit-il être antialiasé? Notez que ceci
d'échelle et de légende créés en utilisant ce nécessite un plus grand nombre de couleurs et
MapFile. Devrait être le plus court possible. entraîne de plus "grosses" images.
PROJECTION BACKGROUNDCOLOR [r] [g] [b]
Signale le début d'un objet PROJECTION. Couleur à utiliser pour l'arrière plan du rectangle
QUERYMAP (panneau d'étiquette). Sans couleur par défaut
Signale le début d'un objet de requête (off).
(QUERYMAP). BACKGROUNDSHADOWCOLOR [r] [g] [b]
REFERENCE Couleur de l'ombrage d'un rectangle (panneau
Signale le début d'un objet carte de référence d'étiquette). Sans par défaut (off).
(REFERENCE MAP). Il s'agit d'une image BACKGROUNDSHADOWSIZE [x][y]
réduite de la carte.
De combien le décalage d'arrière plan d'un
RESOLUTION [int] rectangle doit-il être? 1 par défaut.
Détermine le nombre de pixels par pouce pour BUFFER [integer]
les sorties, concerne seulement les calculs Remplissage, en pixels, autour des étiquettes.
d'échelle et rien d'autre, par défaut 72. Utile pour maintenir un espace autour du texte
SCALE [double] pour en améliorer sa lecture. Disponible
Echelle calculée pour la carte. Souvent calculée seulement pour les étiquettes "cachables". Par
par l'application. défaut 0.
SCALEBAR COLOR [r] [g] [b]
Signale le début d'un objet de barre d'échelle Couleur à utiliser pour dessiner le texte.
(SCALEBAR). FONT [name]
SHAPEPATH [filename] Nom de la police de caractères (comme définie
Chemin du répertoire dans lequel se trouvent dans le FONTSET) à utiliser pour les étiquettes.
les fichier shape. SHAPEPATH peut contenir FORCE [true|false]
des sous-répertoires. Force les étiquettes d'une classe particulière, en
SIZE [x][y] fonction des collisions. Disponible seulement
Taille en pixels de l'image produite (la carte). pour les étiquettes "cachables". Faux par défaut.
STATUS [on|off] MAXSIZE [integer]
La carte est-elle active? Quelque fois vous Taille maximale de la police de caractères à
pourriez souhaiter que non pour utiliser utiliser pour l'échantillonnage du texte (pixels).
seulement la carte référence ou la barre 256 par défaut.
d'échelle. MINDISTANCE [integer]
SYMBOLSET [filename] Distance minimale entre des étiquettes en
Nom complet du fichier de symboles à utiliser. double. Donnée en pixels.
SYMBOL MINFEATURESIZE [integer|auto]
Signale le début d'un objet de symboles Taille minimale d'un élément devant être
(SYMBOL). étiqueté. Donnée en pixels. Pour une donnée de
TRANSPARENT [on|off] type ligne la longueur totale de la ligne affichée
La couleur d'arrière plan doit-elle être est utilisée, pour les polygones la plus petite
transparente pour les cartes. Cet indicateur est dimension de la figure est prise en compte. Le
maintenant délaissé au profit de la déclaration mot clé "Auto" indique à MapServer que seuls
de transparence dans OUTPUTFORMAT. Par les éléments étiquetés qui sont plus grands que
défaut non (off). leur étiquette sont concernés. Disponible
UNITS [feet|inches|kilometers|meters|miles|dd] seulement pour les étiquettes "cachables".
Unités des coordonnées de la carte. Utilisé pour MINSIZE [integer]
la barre d'échelle (scalebar) et les calculs Taille minimale de la police de caractères pour
d'échelle. l'échantillonnage du texte (pixels). 4 par défaut.
WEB OFFSET [x][y]
Signale le début d'un objet WEB.
2
 Valeurs de déplacement pour les étiquettes, CONNECTION [string]
relatif au coin inférieur gauche de l'étiquette ou Chaîne de caractères pour la connexion à une
du point d'étiquette. Donné en pixels. Dans le base de données distante.
cas où la rotation du texte est spécifiée les
valeurs sont identiques pour toutes les Une chaîne de caractères pour une connexion
étiquettes horizontales et toute rotation sera SDE est composée d'un nom de serveur, un
compensée. nom d'instance, un nom de base de données,
OUTLINECOLOR [r] [g] [b] un nom d'utilisateur et son mot de passe
Couleur à dessiner d'un pixel autour du texte. séparés par une virgule.
PARTIALS [true|false]
Le texte doit-il être caché s'il n'est qu'en partie Une chaîne de caractères pour la connexion
dans la carte? Vrai (true) par défaut. PostGIS est fondamentalement identique à une
POSITION [ul|uc|ur|cl|cc|cr|ll|lc|lr|auto] connexion normale PostgreSQL, elle prend la
Position de l'étiquette relative au point forme suivante "user=nobody password=******
d'étiquetage (couches seulement). La première dbname=dbname host=localhost port=5432"
lettre est la position "Y", la seconde lettre est la
position "X". "Auto" indique à MapServer de
calculer une position d'étiquette qui n'interfèrera Une chaîne de caractères pour la connexion
pas avec d'autres étiquettes. Avec des points et Oracle: user/pass[@db]
des polygones, MapServer sélectionne l'une des
8 positions (par exemple en excluant cc). Avec CONNECTIONTYPE [local|sde|ogr|postgis|oraclespatial|
des lignes, il n'utilise que lc ou uc, jusqu'à wms]
trouver une position qui n'entraîne aucune Type de connexion. Par défaut local. Voir la
collision avec des étiquettes déjà dessinées. Si documentation additionnelle pour les autres
toutes les positions entraînent un conflit types.
l'étiquette n'est pas dessinée (sauf si le DATA [filename]|[sde parameters][postgis table/column]
paramètre d'étiquette FORCE est vrai ("true")). [oracle table/column]
"Auto" est seulement disponible avec les Nom complet du fichier de données spatiales à
étiquettes "cachables". traiter. Aucune extension n'est nécessaire pour
SHADOWCOLOR [r] [g] [b] les fichiers shape. Peut être spécifié relatif à
Couleur de l'ombrage. l'option SHAPEPATH de l'objet Map.
SHADOWSIZE [x][y]
Décalage de l'ombrage en pixels. S'il s'agit d'une couche SDE, le paramètre
SIZE [integer]|[tiny|small|medium|large|giant] devrait inclure le nom des couches comme de la
Taille du texte. "integer" pour donner la taille en colonne de géométrie, comme "mylayer,shape".
pixels de votre police TrueType, ou tout autre
des 5 mots clés listés pour les polices bitmap. S'il s'agit d'une couche PostGIS, le paramètre
TYPE [bitmap|truetype] devrait être de la forme "<columnname> from
Type de police de caractères à utiliser. <tablename>", où "columnname" est le nom de
Généralement les polices bitmap sont plus la colonne contenant les objets géométriques et
rapides à dessiner que les polices TrueType. "tablename" est le nom de la table depuis
Malgré tout, les polices TrueType sont ré- laquelle les données géométriques seront lues.
échantillonnables et disponibles en grande
variété de présentation. Assurez-vous que vous
Pour Oracle, utilisez "shape FROM table" ou
avez bien sélectionné TrueType pour le
"shape FROM (SELECT statement)" ou
paramètre FONT.
n'importe quelle autre requête complexe
WRAP [character]
conforme à Oracle! Notez que l'impact sur les
Caractère qui représente une rupture de ligne,
performances est toujours important lors de
produit une étiquette multi-ligne.
l'utilisation de sous-requêtes. Essayez d'utiliser
le FILTER de MapServer aussi souvent que
Objet Layer possible. Vous pouvez aussi voir les requêtes
SQL soumises en forçant une erreur, par
L'objet le plus utilisé dans un MapFile, celui-ci décrit les exemple en soumettant un paramètre DATA
couches utilisées pour fabriquer une carte. Les couches incohérant, en utilisant par exemple un mauvais
sont dessinées dans leur ordre d'apparition dans le nom de colonne.
MapFile (la première couche dessous, la dernière sur le
dessus). DEBUG
Permet la mise au point de l'objet de couche.
CLASS Les sorties sont générées et envoyées vers la
Signale le début d'un objet de classe (CLASS). sortie standard d'erreur (STDERR) ou dans le
CLASSITEM [attribute] fichier de trace de MapServer si le paramètre
Nom d'élément dans la table attribut pour utiliser LOG de l'objet WEB est renseigné.
dans les recherches de classe. DUMP [true|false]
3
 Commutateur pour permettre de retourner la Paramètre le contexte pour l'étiquetage de cette
donnée au format GML. Très utile quand vous couche, par exemple:
utilisez les opérations GetFeatureInfo de WMS. LABELREQUIRES ([orthoquads] != 1)
"false" est la valeur par défaut.
FEATURE veut dire que cette couche ne sera pas
Signale le début d'un objet de fonction étiquetée si la couche nommée "orthoquads" est
(FEATURE). visible (on). L'expression consiste en une
FILTER [string] expression booléenne basée sur l'état des
Ce paramètre permet un filtrage spécifique autres couches, chaque sous-chaîne [layer
d'attribut de données en même temps que le name] est remplacée par un 0 ou un 1 selon les
filtrage spatial est effectué, mais avant que toute états (STATUS) de couche et ensuite évalué
expression CLASS soit évaluée. Pour OGR et normalement. Les opérateurs logiques AND et
les fichiers shape la chaîne de caractères est OR peuvent être utilisés.
simplement une expression régulière
MapServer. Pour les bases de données LABELSIZEITEM [attribute]
spatiales la chaîne de caractères est une Nom de l'élément de la table attribut à utiliser
requêtes SQL WHERE qui est valide en comme classe des tailles d'étiquette. Les
respectant la base de données considérée. valeurs sont en pixels.
MAXFEATURES [integer]
Par exemple: FILTER "type='road' and size <2" Specifie le nombre de fonctions qui seront
dessinées pour cette couche dans la fenêtre
FILTERITEM [attribute] courante. Intéressant avec les étiquettes et avec
Elément à utiliser avec des expressions simples les données triées (comme les lacs par zone).
FILTER. OGR et fichiers shape seulement. MAXSCALE [double]
FOOTER [filename] Echelle maximale à laquelle cette couche est
Mise en forme à utiliser après qu'une couche dessinée.
produise ses résultats. Mode de requête METADATA
multirésultat seulement. Ce mot clé permet d'enregistrer des données
GROUP [name] comme un couple de valeurs. Ceci est utilisé
Nom d'un groupe auquel la couche appartient. avec OGC WMS pour définir des éléments
Le nom de groupe peut être référencé ensuite comme le titre de la couche. Il peut aussi
comme un nom normal de couche dans les permettre plus de souplesse en créant des
fichiers de mise en forme, permettant de faire mises en forme, puisque tout ce que vous
certaines opérations comme afficher ou cacher mettrez ici sera accessible via les indicateurs de
un groupe de plusieurs couches en une seule mise en forme.
opération.
HEADER [filename] Exemple:
Mise en forme à utiliser avant qu'une couche
produise ses résultats. Mode de requête METADATA
multirésultat seulement. title "My layer title"
LABELANGLEITEM [attribute] author "Me!"
Nom d'élément dans la table d'attribut à utiliser END
pour la classe d'annotation des angles. Les
valeurs sont exprimées en degrés.
LABELCACHE [on|off] MINSCALE [double]
Specifie quand les étiquettes devraient être Echelle minimale à laquelle cette couche est
tracées comme une fonction pour cette couche, dessinée.
ou quand elles doivent être dissimulées et NAME [string]
dessinées après que toutes les couches aient Nom court de cette couche. La limite est de 20
été dessinées. Par défaut on. Le recouvrement caractères. Ce nom est le lien entre le mapfile et
d'étiquetage, placement automatique etc... ne les interfaces oueb qui se réfèrent à ce nom. Ils
sont disponibles que lorsque le cache d'étiquette doivent être identiques. Le nom devra être
est actif. unique, sinon une couche en remplacera une
LABELITEM [attribute] autre à différentes échelles. Utilisez l'option
Nom de l'élément dans la table attribut à utiliser GROUP pour associer les couches entre elles.
comme source de l'étiquetage. OFFSITE [r] [g] [b]
LABELMAXSCALE [double] Sélectionne l'index de couleur pour la
Echelle maximale à laquelle la couche est transparence des couches raster.
étiquetée. POSTLABELCACHE [true|false]
LABELMINSCALE [double] Indique à MapServer de restituer cette couche
Echelle minimale à laquelle la couche est après que toutes les étiquettes en cache auront
étiquetée. été dessinées. Très utile pour ajouter une
LABELREQUIRES [expression]

4
 touche finale et autres éléments similaires. Faux TOLERANCE [double]
par défaut (false). Sensibilité pour les requêtes basées sur les
PROCESSING [string] points (par exemple via la souris et/ou les
Passe une directive de procédure à utiliser avec coordonnées de la carte). Donnée en
cette couche. Les directives de procédure TOLERANCEUNITS avec 3 pixels par défaut.
reconnues varient en fonction du type de Pour restreindre les recherches par polygone, le
couche et du pilote sous-jacent qui les traitera. point doit être inclus dans le polygone
Actuellement les directives SCALE, BANDS et sélectionné avec une tolérance de zéro.
DITHER sont reconnues pour les couches raster TOLERANCEUNITS [pixels|feet|inches|kilometers|
traitées via le pilote GDAL. Ceci est expliqué meters|miles|dd]
dans le document Raster HOWTO. Unité de la valeur TOLERANCE. pixels par
défaut.
Exemple: TRANSPARENCY [integer]
Sélectionne le niveau de transparence de tous
les pixels d'une couche donnée. La valeur est
PROCESSING "SCALE_1=AUTO"
en pourcentage (0-100) où 100 est opaque et 0
PROCESSING "SCALE_2=AUTO"
est complètement transparent.
PROCESSING "SCALE_3=AUTO"
TRANSFORM [true|false]
PROCESSING "BANDS=3,2,1,4"
Indique à MapServer si une couche particulière
a besoin d'être transformée d'un système de
coordonnées vers les coordonnées d'image.
PROJECTION
Vrai (true) par défaut. Ceci permet de créer des
Signale le début d'un objet de PROJECTION.
fichiers shape dans les coordonnées
REQUIRES [expression]
image/graphiques et ensuite de disposer de la
Sélectionne le contexte pour l'affichage de cette
possibilité d'être affiché au même endroit sur
couche (voir LABELREQUIRES).
toute carte. Idéal pour placer des logos ou du
SIZEUNITS [pixels|feet|inches|kilometers|meters|miles|
texte dans les cartes. Rappelez vous que le
Sélectionne l'unité de l'objet CLASS pour la
système de coordonnées graphiques a comme
valeur de taille (SIZE), pixels par défaut.
origine le coin supérieur gauche de l'image,
STATUS [on|off|default]
contrairement à la plupart des systèmes de
Sélectionne l'état actuel de la couche.
coordonnées cartographique.
Fréquemment modifié par MapServer lui-même.
TYPE [point|line|polygon|circle|annotation|raster|query]
La couche est 'on' en permanence par défaut,
Spécifie comment les données doivent être
donc visible et dessinée.
tracées. N'a pas besoin d'être identique au type
STYLEITEM [attribute]
du fichier shape. Par exemple, un fichier shape
Elément à utiliser pour le design des fonctions
polygone peut être dessiné comme une couche
spécifiques. Ceci est *très* expérimental et
point, mais un fichier shape point ne peut pas
seulement OGR pour l'instant.
être dessiné comme une couche polygone.
SYMBOLSCALE [double]
C'est assez normal. Annotation signifie que
Echelle à laquelle les symboles et/ou les textes
l'étiquette de point sera calculée pour les
apparaissent en pleine taille. Ceci permet
fonctions, mais la fonction elle même ne sera
l'échelle dynamique des objets basés sur
l'échelle de la carte. Si non utilisé, alors cette pas dessinée quoique un symbole de marquage
puisse être dessiné. Facultativement, ceci
couche apparaitra toujours à la même taille.
permet un étiquetage avancé comme
L'échelle doit être comprise dans les limites de
l'étiquetage des symboles d'autoroute (aux US
MINSIZE et MAXSIZE comme décrit ci-avant.
représenté par un écusson). Les points sont
TEMPLATE [file|url]
étiquetés à ce point. Les polygones sont
Utilisé comme une alternative à
étiquetés au premier centroïde, et si ça ne
CLASS TEMPLATE
tombe pas dans le polygone une ligne de lien
TILEINDEX [filename]
est utilisée pour garantir que l'étiquette est bien
Nom complet du fichier pour l'index ou la
rattachée à cet élément. Les lignes sont
définition d'assemblage pour cette couche.
étiquetées au milieu de la section visible la plus
Similaire à une bibliothèque d'index ArcInfo, ce
longue de la ligne. Query indique seulement que
fichier shape contient des polygones pour
cette couche peut être interrogée mais non
chaque carreau à assembler. L'élément contient
dessinée.
la localisation du carreau indiquée par le
paramètre TILEITEM. Si le paramètre DATA
contient une valeur alors il est ajouté à la fin de De manière à faire la différence entre les
la localisation. Si DATA est vide alors la POLYGONs et les POLYLINEs (qui n'est pas un
localisation devrait contenir le nom de fichier type existant), il faut simplement veiller à utiliser
entier. ou non le mot clé COLOR dans la classification.
TILEITEM [attribute] Si vous l'utilisez, il s'agira d'un polygone avec
Elément contenant la localisation d'un carreau une couleur de remplissage, sinon c'est une
individuel d'assemblage, par défaut "location". polyligne avec seulement une
OUTLINECOLOR.
5
 Un cercle peut être défini par un rectangle opérateurs logiques connus sont :
inscrit. Ainsi 2 points définissent le carré =,>,<,<=,>=,=,or,and,lt,gt,ge,le,eq.
minimum qui le contient. Ces 2 points sont deux Comme vous pouvez vous en douter ce
coins opposés d'une telle figure. niveau de complexité est relativement
lent à évaluer.
Objet Class
Les comparaisons chaîne de caractères et les
Définit les classes thématiques pour une couche donnée expressions régulières fonctionnent depuis le
et toute couche doit avoir au moins une classe. Pour les CLASSITEM défini au niveau de la couche.
cas où il y a plusieurs classes, l'appartenance est Vous pouvez mélanger les types d'expression
déterminée en utilisant les valeurs d'attribut et les au sein de différentes classes d'une couche.
expressions. Commence avec le mot clé CLASS et se
termine avec le mot clé END. JOIN
Signale le début d'un objet JOIN.
BACKGROUNDCOLOR [r] [g] [b] LABEL
Couleur à utiliser pour les symboles non Signale le début d'un objet LABEL.
transparents. MAXSIZE [integer]
COLOR [r] [g] [b] Taille maximale en pixels pour dessiner un
Couleur à utiliser pour dessiner les fonctions. symbole. 50 par défaut.
DEBUG MINSIZE [integer]
Permet la mise au point de l'objet de classe. Les Taille minimale en pixels pour dessiner un
sorties sont générées et envoyées vers la sortie symbole. 0 par défaut.
d'erreur standard (STDERR) ou vers le fichier NAME [string]
trace de MapServer si le paramètre LOG est Nom à utiliser dans les légendes pour cette
renseigné dans l'objet WEB. classe. Si non indiqué, ne sera pas montré dans
EXPRESSION [string] la légende.
Trois types d'expressions sont maintenant OUTLINECOLOR [r] [g] [b]
supportés pour définir le lien de classe. Les Couleur à utiliser pour dessiner les polygones et
comparaisons chaîne de caractères, les certains symboles de marquage. Les symboles
expressions régulières et les expressions de ligne ne sont pas concernés par cet élément.
logiques simples. Si aucune expression n'est SIZE [integer]
donnée, alors toutes les fonctions sont réputées Hauteur, en pixels, du symbole/motif à utiliser.
appartenir à cette classe. Très utile seulement avec les symboles
rééchantillonnables. 1 par défaut.
SYMBOL [integer|string]
• Les comparaisons chaîne de caractères
Le nom du symbole ou le numéro à utiliser pour
ne sont pas sensibles à la casse et sont
toutes les fonctions si les tables d'attribut ne
les plus rapides à être évaluées. Aucun
sont pas utilisées. Le numéro est l'index du
délimiteur particulier n'est nécessaire
symbole dans le fichier de symboles, commence
bien que la chaîne de caractères soit à
à 1, le 5ième symbole dans le fichier est donc le
mettre entre guillemets si elle contient
symbole numéro 5. Vous pouvez aussi donner
des caractères spéciaux. (En guise de
les noms des symboles en utilisant le mot clé
bonne habitude, il est recommandé de
NAME dans le fichier de définition des
toujours utiliser les guillemets).
symboles. 0 par défaut, qui produit un simple
• Les expressions régulières fonctionnent
pixel, une ligne fine ou un polygone plein selon
exactement comme dans les versions le type de la couche.
précédentes de MapServer. Toutefois, TEMPLATE [filename]
vous devez maintenant délimiter une Fichier de mise en forme ou URL à utiliser pour
expression régulière en utilisant /regex/. présenter le résultat de requête à l'utilisateur.
Aucun guillemet ne doit être utilisé. TEXT [string]
• Les expressions logiques vous Texte fixe pour étiqueter les éléments de cette
permettent de construire des tests classe. Ceci remplace les valeurs obtenues par
franchement complexes basés sur un LABELITEM. La chaîne de caractères peut être
ou plusieurs attributs et seulement avec donnée comme une expression délimitée en
les fichiers shape. Les expressions utilisant des parenthèses. Ceci vous permet
logiques sont délimitées par des d'assembler plusieurs attributs en une seule
parenthèses "(expression)". Les noms étiquette. Par exemple: ([FIRSTNAME],
d'attribut sont délimités par des crochets [LASTNAME]).
"[ATTRIBUTE]". Ces noms sont
sensibles à la casse et doivent
correspondre aux éléments du fichier Vous pouvez aussi "mélanger" 2 symboles pour obtenir
shape. Par exemple: EXPRESSION des effets particuliers. Vous définissez le second
([POPULATION] > 50000 AND symbole, qui est effectivement plaqué par dessus le
'[LANGUAGE]' eq 'FRENCH') ... Les symbole normalement défini précédemment.
6
Les paramètres suivants vous permettent de définir le POSITION [ul|uc|ur|ll|lc|lr]
symbole et ils sont équivalents à leurs contreparties non Où doit être placée la légende sur la carte. lr par
recouvrable: défaut.
KEYSIZE [x][y]
• OVERLAYBACKGROUNDCOLOR Taille de la case de symboles en pixels. 20 par
• OVERLAYCOLOR 10 par défaut.
• OVERLAYOUTLINECOLOR KEYSPACING [x][y]
Espacement entre les symboles ([y]) et les
• OVERLAYSIZE
étiquettes ([x]) en pixels. 5 par 5 par défaut.
• OVERLAYMINSIZE
POSTLABELCACHE [true|false]
• OVERLAYMAXSIZE Indique à MapServer de restituer cette légende
• OVERLAYSYMBOL après que toutes les étiquettes du cache aient
été dessinées. Très utile pour ajouter une
Objet de fonction (Feature) touche finale ou quelqu'autres éléments
similaires. Faux (false) par défaut.
Définit les fonctions en ligne. Vous pouvez utiliser les STATUS [on|off|embed]
fonctions en ligne quand il n'est pas possible (ou trop de L'image légende doit-elle être créée?
difficultés) pour créer un fichier shape. Les fonctions en TRANSPARENT [on|off]
ligne peuvent aussi être construites via des URL ou des La couleur d'arrière plan pour la légende est-elle
formulaires. Commence par le mot clé FEATURE et se transparente? Cet indicateur est maintenant
termine avec le mot clé END. délaissé au profit de la déclaration de
transparence dans OUTPUTFORMAT. Non par
POINTS défaut (off).
Un ensemble de couples xy terminé avec END,
par exemple: QueryMap Object
POINTS 1 1 50 50 1 50 1 1 END
Définit un mécanisme pour appliquer les résultats d'une
Notez qu'avec les couches requête sur la carte. Commence avec le mot clé
POLYGON/POLYLINE les POINTS doivent QUERYMAP et se termine avec le mot clé END.
commencer et se terminer au même point (pour
fermer la fonction). COLOR [r] [g] [b]
Couleur avec laquelle la "surbrillance" est
TEXT [string] effectuée. Jaune par défaut.
Chaîne de caractères à utiliser pour étiqueter SIZE [x][y]
cette fonction. Taille de la carte en pixels. Par défaut taille
définie dans l'objet Map.
Objet de légende (Legend) STATUS [on|off]
La requête doit-elle être dessinée?
STYLE [normal|hilite|selected]
Définit comment une légende doit être construite. Les
Paramètre comment les fonctions sélectionnées
composants de la légende sont construits
sont gérées. Les couches non interrogées sont
automatiquement à partir des objets de classe pour
dessinées normalement.
chaque couche. Commence avec le mot clé LEGEND et
se termine avec le mot clé END. La taille de l'image de
légende N'EST PAS connue à priori pour la création • Normal: dessine toutes les fonctions
aussi soyez prudent avec les éléments largeur et selon les paramétrages de cette
hauteur de l'indicateur <IMG> du fichier de mise en couche.
forme. • Hilite: dessine les fonctions
sélectionnées en utilisant COLOR. Les
IMAGECOLOR [r] [g] [b] fonctions non sélectionnées sont
Couleur dans laquelle la légende est initialisée dessinées normalement.
(l'arrière plan). • Selected: dessine seulement les
INTERLACE [on|off] fonctions sélectionnées normalement.
L'image devra-t-elle être entrelacée? Oui par
défaut [on]. Ce mot clé est maintenant délaissé Objet de jointure (Join)
au profit de l'option FORMATOPTION
"INTERLACE=ON" dans la déclaration Définit comment une jointure particulière est gérée.
OUTPUTFORMAT. Commence avec le mot clé JOIN et se termine avec le
LABEL mot clé END. Les jointures sont définies dans un objet
Signale le début de l'objet LABEL de requête (query).
OUTLINECOLOR [r] [g] [b]
Couleur de base des lignes externes des FROM [item]
symboles. Elément de jointure dans le fichier shape.
7
NAME [string] BACKGROUNDCOLOR [r] [g] [b]
Nom unique pour cette jointure. Obligatoire. Couleur à utiliser pour l'arrière plan de la barre
TABLE [file] d'échelle, et non pas de l'arrière plan de l'image.
Nom du fichier XBase (DBF, doit être un chemin COLOR [r] [g] [b]
complet) pour la jointure cible (TO). Couleur à utiliser pour dessiner toutes les
TEMPLATE [filename] fonctions si les tables d'attribut ne sont pas
Mise en forme à utiliser avec une jointure un- utilisées.
vers-plusieurs. La mise en forme est effectuée IMAGECOLOR [r] [g] [b]
une fois pour chacun des enregistrement et peut Couleur avec laquelle la barre d'échelle est à
seulement contenir des substitutions pour les initialiser (arrière plan).
éléments de la table des jointures. INTERLACE [true|false]
TO [item] Les images doivent-elles être entrelacées? Oui
Elément jointure dans la table des jointures. par défaut [on]. Ce mot clé est maintenant
TYPE [multiple|single] délaissé au profit de l'option FORMATOPTION
Le type de jointure. Simple (single) par défaut "INTERLACE=ON" dans la déclaration
(un-vers-un). OUTPUTFORMAT.
INTERVALS [integer]
Objet de carte de référence Nombre d'intervals de séparation dans la barre
d'échelle. 4 par défaut.
LABEL
Définit comment les cartes référence doivent être
Signale le début d'un objet LABEL
créées. Commence avec le mot clé REFERENCE et se
OUTLINECOLOR [r] [g] [b]
termine avec le mot clé END. Trois types de cartes de
Couleur à utiliser pour tracer les intervals. Tous
référence sont reconnus. La plus commune est celle qui
composants à -1 pour ne rien tracer, ce qui est
montre en une seule image interactive la carte. Il est
la valeur par défaut.
aussi possible d'interroger les cartes référence comme
POSITION [ul|uc|ur|ll|lc|lr]
un élément d'une requête. Les requêtes point
Où placer la barre d'échelle dans l'image. lr par
génèreront une image avec un marquage (voir plus loin)
défaut.
placé au point interrogé. La region basée sur les
POSTLABELCACHE [true|false]
requêtes décrira l'étendue de la zone d'intérêt.
Pour utiliser avec les barres d'échelle
Finalement, la fonction basée sur les requêtes affichera
incrustées. Indique à MapServer d'étendre la
les fonctions sélectionnées utilisées.
barre d'échelle après que toutes les étiquettes
en cache aient été dessinées. Non par défaut
COLOR [r] [g] [b] (false).
Couleur dans laquelle le cadre de référence est SIZE [x][y]
dessiné. Chaque composant à -1 pour un rendu Taille en pixels de la barre d'échelle.
vide. Rouge par défaut. L'étiquetage n'est pas pris en compte.
EXTENT [minx][miny][maxx][maxy] STATUS [on|off|embed]
L'étendue spatiale de base de l'image référence. La barre d'échelle doit-elle être créée, et doit-
IMAGE [filename] elle être incrustée dans l'image? Non par défaut
Nom complet du fichier contenant l'image de (off). (Notez que la barre d'échelle incrustée
référence. Doit être au format GIF. nécessite de définir un ensemble de marqueurs.
OUTLINECOLOR [r] [g] [b] En fait la barre d'échelle devient un marqueur
Couleur à utiliser pour encadrer la référence. personnalisé qui est géré exactement comme
Tous les composants à -1 pour ne pas encadrer. n'importe quelle annotation.)
SIZE [x][y] STYLE [integer]
Taille, en pixels, de l'image référence. Choisit le style de la barre d'échelle. Les styles
STATUS [on|off] valides sont 0 et 1.
La carte référence doit-elle être créée? Non par TRANSPARENT [on|off]
défaut (off). La couleur d'arrière plan de la barre d'échelle
doit-elle être transparente? Cet indicateur est
Objet barre d'échelle (Scalebar) maintenant délaissé au profit de la déclaration
de transparence dans OUTPUTFORMAT. Non
Définit comment une barre d'échelle devra être par défaut (off).
construite. Commence avec le mot clé SCALEBAR et se UNITS [feet|inches|kilometers|meters|miles]
termine avec le mot clé END. Les barres d'échelle Unité de la barre d'échelle, miles par défaut.
n'utilisent pas les polices TrueType. La taille de l'image Utilisé en combinaison avec les unités de la
de la barre d'échelle N'EST PAS connue à priori, aussi carte pour développer le graphique actuel.
soyez prudent lors de l'utilisation de la hauteur et de la Notez que les degrés décimaux ne sont pas
largeur dans l'indicateur <IMG> du fichier de mise en valides comme unités de la barre d'échelle.
forme. Les versions ultérieures rendront possible la
définition de la taille de l'image. Objet Web

8
Définit comment l'interface oueb opèrera. Commence Echelle minimale pour laquelle cette interface
avec le mot clé WEBet se termine avec le mot clé END. est valide. Quand un utilisateur demande une
carte à une échelle plus petite MapServer
EMPTY [url] retourne automatiquement la carte à cette
URL où renvoyer les utilisateurs si une requête échelle. Ceci empêche effectivement l'utilisateur
n'aboutit pas. Si rien n'est défini la valeur de de dépasser ce seuil de zoom.
ERROR est utilisée. MINTEMPLATE
ERROR [url] Mise en forme à utiliser dans le cas ou l'échelle
URL où renvoyer les utilisateurs si une erreur minimale est dépassée, utile pour enchaîner des
survient. De très vieux et très vilains messages applications.
d'erreur apparaitront si rien n'est défini ici. TEMPLATE [filename|url]
FOOTER [filename] Mise en forme ou URL à utiliser pour la
Mise en forme à utiliser APRES que tout ait été présentation des résultats à l'utilisateur dans un
envoyé. Pour les résultats multiples de requête mode interactif.
seulement.
HEADER [filename] Objet Projection
Mise en forme à utiliser AVANT que quoique ce
soit d'autre ait été envoyé. Pour les résultats Pour déterminer les projections vous devez définir deux
multiples de requête seulement. objets de projection: l'un pour l'image à produire (dans
IMAGEPATH [path] l'objet MAP) et l'autre pour chaque couche (dans les
Chemin vers le répertoire temporaire pour objets LAYER) à projeter. Les objets de projection
l'écriture temporaire de fichiers et d'images. Doit consistent en une simple série de mot clé PROJ.4. Voici
être accessible en écriture par l'utilisateur pour un exemple définissant la projection UTM zone 15,
le compte duquel fonctionne le serveur HTTP. NAD83:
Doit se terminer par un / ou \ selon votre
système d'exploitation.
PROJECTION
IMAGEURL [path] "proj=utm"
URL base pour IMAGEPATH. Ceci est l'URL qui "ellps=GRS80"
sera employée par le navigateur oueb vers "zone=15"
IMAGEPATH pour obtenir les images. "north"
LOG [filename] "no_defs"
Fichier de trace de l'activité de MapServer. Doit END
être accessible en écriture par l'utilisateur pour
le compte duquel fonctionne le serveur HTTP.
MAXSCALE [double]
Echelle maximale pour laquelle cette interface Les coordonnées géographiques sont définies ainsi:
est valide. Quand un utilisateur demande une
carte à une échelle plus grande MapServer PROJECTION
retourne automatiquement la carte à cette "proj=latlong"
échelle. Ceci empêche l'utilisateur d'effectuer un END
zoom trop grand.
MAXTEMPLATE [file|url]
Mise en forme à utiliser pour l'échelle maximale Voir le guide utilisateur de PROJ.4 pour une description
définie, utile pour enchaîner des applications. complète des projections supportées et des systèmes
METADATA de coordonnées.
Ce mot clé permet de stocker des données sous
la forme de couples de valeurs. Ceci est utilisé Objet OutputFormat
avec OGC WMS pour définir des choses telles
qu'un titre de couche. Il peut aussi permettre
Cette partie expose comment les formats de sortie sont
une plus grande souplesse pour la création de
définis et sélectionnés.
mises en forme, puisque tout ce que vous
mettrez ici sera accessible via des indicateurs
de mise en forme. Une carte peut avoir zéro, une ou plusieurs déclarations
d'objet OUTPUTFORMAT, définissant les formats de
sortie supportés incluant des formats comme PNG, GIF,
Exemple:
JPEG, GeoTIFF et Flash (SWF).
METADATA
Si les déclarations OUTPUTFORMAT ne sont pas
title "My layer title"
trouvées dans le mapfile, la déclaration implicite sera
author "Me!"
appliquée. Seuls les formats qui ont été inclus à la
END
compilation sont disponibles. Le GeoTIFF dépend de la
construction du support GDAL, et le Flash (SWF)
dépend de la compilation avec la bibliothèque MING.
MINSCALE [double]
9
OUTPUTFORMAT supportent pas toutes les combinaisons. Par
NAME gif exemple GD/GIF ne supporte que PC256.
DRIVER "GD/GIF" (optionnel)
MIMETYPE "image/gif"
IMAGEMODE PC256 • PC256: Produit un résultat en pseudo
EXTENSION "gif" couleur avec une palette de 256
END couleurs (mode traditionnel de
OUTPUTFORMAT MapServer)
NAME png • RGB: Restitue un mode 24 bits RGB.
DRIVER "GD/PNG" Supporte toutes les couleurs mais ne
MIMETYPE "image/png" supporte pas la transparence.
IMAGEMODE PC256 • RGBA: Restitue un mode 32 bits
EXTENSION "png" RGB/Alpha. Supporte toutes les
END couleurs, et la transparence basée
OUTPUTFORMAT alpha.
NAME jpeg
• INT16: Restitue une bande de données
DRIVER "GD/JPEG"
avec une profondeur de 16 bits. Ne
MIMETYPE "image/jpeg"
fonctionne que pour les couches
IMAGEMODE RGB
RASTER (à travers GDAL) et les
EXTENSION "jpg"
couches WMS.
END
• FLOAT32: Restitue une bande de
OUTPUTFORMAT
données avec une profondeur de 32
NAME wbmp
bits. Ne fonctionne que pour les
DRIVER "GD/WBMP"
couches RASTER (à travers GDAL) et
MIMETYPE "image/wbmp"
les couches WMS.
IMAGEMODE PC256
EXTENSION "wbmp"
END MIMETYPE [type]
OUTPUTFORMAT Fournit le type mime à utiliser quand les
NAME swf résultats sont envoyés sur le oueb. (optionnel)
DRIVER "SWF" EXTENSION [type]
MIMETYPE "application/x-shockwave-flash" Fournit l'extension à utiliser pour la création des
EXTENSION "swf" fichiers de ce type. (optionnel)
END TRANSPARENT [ON/OFF]
OUTPUTFORMAT Indique quand la transparence pourra être
NAME GTiff disponible pour ce format. Notez que cette
DRIVER "GDAL/GTiff" transparence ne fonctionne pas avec le format
MIMETYPE "image/tiff" de sortie IMAGEMODE RGB. Tous les formats
IMAGEMODE RGB ne supportent pas la transparence.(optionnel)
EXTENSION "tif" FORMATOPTION [option]
END Fournit une option spécifique du format au
pilote. Zéro ou plusieurs éléments
FORMATOPTION peuvent être présents dans la
NAME [name] déclaration OUTPUTFORMAT. (optionnel)
Le nom à utiliser dans le mot clé IMAGETYPE
du mapfile pour sélectionner ce format de sortie. • GD/JPEG: L'option "QUALITY=n" peut
(optionnel) être utilisée pour déterminer la qualité
DRIVER [name] du JPEG produit (valeur de 0 à 100).
Le nom du pilote à utiliser pour générer ce • GD/PNG: L'option
format de sortie. Certains noms de pilote "INTERLACE=[ON/OFF]" peut être
intègrent la définition du format si le pilote utilisée pour activer (on) ou désactiver
dispose de plusieurs formats. Pour GD les noms (off) l'entrelacement.
possibles du pilote sont "GD/Gif", "GD/PNG", • GD/GIF: L'option
"GD/WBMP" et "GD/JPEG". Pour le pilote flash "INTERLACE=[ON/OFF]" peut être
il se nomme simplement "SWF". Pour les sorties utilisée pour activer (on) ou désactiver
à travers GDAL le nom court GDAL pour le (off) l'entrelacement.
format est ajouté, comme "GDAL/GTiff". Notez • GDAL/GTiff: Supporte les carroyages,
que la sortie PNG, JPEG ou GIF peut être les options spécifique de format sont
générée avec GDAL ou GD (GD est TILED=YES, BLOCKXSIZE=n,
généralement plus efficace).(obligatoire) BLOCKYSIZE=n,
IMAGEMODE [PC256/RGB/RGBA/INT16/FLOAT32] INTERLEAVE=[PIXEL/BAND] et
Sélectionne le mode d'image dans lequel la COMPRESS=[NONE,PACKBITS,JPEG,
sortie est générée. Important pour les formats LZW,DEFLATE].
non raster comme Flash. Tous les formats ne
10
 • GDAL/*: Tous les FORMATOPTION IMAGE [string]
sont passés à la fonction de création de Image (GIF ou PNG) à utiliser comme marqueur
GDAL. Les options disponibles dans ou pinceau pour les symboles de type PIXMAP.
GDAL sont décrites dans la NAME [string]
documentation détaillée de chacun des Alias pour cette police à utiliser dans les objets
formats GDAL. CLASS.
POINTS [x y] [x y] ... END
Référence de la symbologie Signifie le début de la définition de points qui
constituent un symbole vectoriel ou qui
déterminent les x et y du rayon d'un symbole
Cette partie explique comment travailler avec les
ellipse. La fin de cette section est indiquée avec
symboles et comment les définir dans MapServer.
le mot clé END. Les coordonnées sont données
en pixels et définissent la taille par défaut du
Notes symbole avant toute application d'échelle. Vous
pouvez créer des éléments non contiguës en
• Les définitions de symbole peuvent être incluses insérant des coordonnées négatives à la place
dans le MapFile principal ou, plus appropriée. Pour les symboles ellipse vous
communément, dans un fichier séparé. Les indiquez un simple point qui détermine les x et y
définitions de symbole dans un fichier séparé du rayon d'une ellipse. Les cercles sont créés
sont désignées en utilisant le mot clé quand le x et le y sont égaux.
SYMBOLSET, comme une partie de l'objet Map. STYLE [num on] [num off] [num on] ... END
Ce paramétrage recommandé est idéal pour Définit un style de tache ou un motif.
une réutilisation des symboles dans plusieurs TRANSPARENT [color index]
applications MapServer. Indique une couleur de transparence pour
• Il y a 3 types principaux de symboles dans l'image GIF source pour les symboles pixmap,
MapServer: Markers, Shadesets, et Lines. ou détermine quand tous les symboles ombrés
• Le symbole 0 est toujours un "dégénéré" d'une peuvent avoir une couleur d'arrière plan
classe particulière de symbole. Pour les points, transparente. Pour les symboles ombrés il peut
le symbole 0 est un seul pixel, pour les être souhaitable d'avoir une fonction d'arrière
ombrages (comme le remplissage des plan "vue à travers" un motif de remplissage
polygones) le symbole 0 est un remplissage de transparent, en créant une carte plus complexe.
type plein, et pour les lignes, le symbole 0 est un Par défaut, l'arrière plan du symbole est le
seul pixel pour une ligne fine. même que l'image parente (couleur 0). Ceci est
• Les définitions de symboles ne contiennent configurable par l'utilisateur.
aucune information de couleur, les couleurs sont TYPE [vector|ellipse|pixmap|truetype|simple]
positionnées dans les objets CLASS.
• Un fichier peut contenir un maximum de 64 • vector: un simple tracé pour définir le
symboles. Ceci peut être changé en modifiant la contour du symbole.
valeur de MS_MAXSYMBOLS dans • ellipse: valeurs de rayon dans les
mapsymbol.h au début du fichier. directions x et y définissant une ellipse.
• pixmap: une image GIF de l'utilisateur
Syntaxe qui sera utilisée comme symbole.
• truetype: police TrueType à utiliser
ANTIALIAS [true|false] comme indiqué dans FONTSET.
Les polices TrueType devraient pouvoir être
"antialiasées". Exemples
CHARACTER [char]
Caractère utilisé pour référencer une police de Voici quelques exemples illustrant les différentes
caractères TrueType particulière. Vous devrez manières de créer les symboles dans MapServer:
imaginer une translation entre le clavier et le
caractère correspondant. Example 1. Ligne pointillée
FILLED [true|false]
Indique que le symbole est à remplir avec la
couleur définie (voir l'objet CLASS). Pour les SYMBOL
symboles de marquage, si OUTLINECOLOR a NAME 'dashed1'
été indiqué le symbole est tracé dans cette TYPE ELLIPSE
couleur. POINTS 1 1 END
FONT [string] FILLED true
Nom de la police TrueType à utiliser comme STYLE 10 5 5 10 END
indiqué dans FONTSET. END
GAP [int]
Donné en pixels. Détermine une distance entre Ceci crée une ligne pointillée de 10 pixels, puis 5 pixels
les symboles pour les lignes TrueType. vides, 5 pixels, 10 pixels vides ...

11
Example 2. Symbole marqueur police TrueType FILLED true
POINTS
SYMBOL 11
NAME "natcap" END
TYPE TRUETYPE END
FONT geo
FILLED true
ANTIALIAS true Un simple cercle plein. L'utilisation de valeurs non
CHARACTER "&#114;" égales pour le point donnera une ellipse.
END
Example 6. Diagonale descendante de remplissage

Ce symbole est une étoile, utilisé pour représenter la SYMBOL

capitale nationale, comme l'indique son nom (en anglais NAME "downwarddiagonalfill"
national capital, en français on aurrait pu mettre capnat). TYPE vector
Le nom de la police est déterminé dans le fichier TRANSPARENT 0
FONTSET. Le code numérique "114" varie, vous pouvez POINTS
utiliser la table des caractères MS Windows. 01
10
Example 3. Symbole marqueur triangle vecteur END
END
SYMBOL
NAME "triangle" 2. Connection MapFile layer to PostGIS
TYPE vector
POINTS
04 First I am going to show the difference between
20 connecting the MapFile to a Shapefile layer and to a
44 PostGIS layer, then I will show how to adapt your
04 MapFile to work with PostGIS.
END
END Shapefile Connection

Here is a sample connection from MapFile to a shapefile

Notez que pour avoir 3 côtés vous devez avoir 4 points, called "compfun".
bien que les premier et dernier points soient identiques.
First you need to declare the path to the shape data
Example 4. Symbole marqueur vecteur non (SHAPEPATH).
contiguës (Croix)
Then for each shapefile layer you have to set the
SYMBOL shapefile's data source (DATA) that is the name of the
NAME "cross" shapefile. Here the shapefile is named compfun.shp so
TYPE vector DATA is set to "compfun".
POINTS
20 Note that NAME can be anything, it means how in your
24 MapFile want to call the shapefile layer.
-99 -99
02
42 MAP
END ...
END SHAPEPATH "C:\training\mapServerTutorial\data"
...
LAYER
NAME "compfun"
Cet exemple dessine une croix, ce sont 2 lignes TYPE POLYGON
(vecteurs) qui ne sont pas connectées à la suite (comme STATUS ON
le triangle dans l'exemple précédent). Les valeurs DATA "compfun"
négatives séparent les deux. CLASS
STYLE
Example 5. Symbole vecteur cercle COLOR 255 235 190
OUTLINECOLOR 0 0 0
SYMBOL SYMBOL 0
NAME "circle" END
TYPE ellipse END
12
END MAP
... NAME "Zone Samples"
SHAPEPATH "C:\training\mapServerTutorial\data"
PostGIS Connection SIZE 400 400
STATUS ON
EXTENT 1143759 4417539 1146436 4420390
All the connection properties can be defined in the
UNITS METERS
LAYER section of MapFile.
FONTSET "fonts\fonts.list"
WEB
Obviously there is no need to set a SHAPEPATH IMAGEPATH "C:\Inetpub\wwwroot\temp"
attribute, unless you want to serve some shapefile layer IMAGEURL "C:\Inetpub\wwwroot\temp"
togheter with PostGIS layers. END

Basically in the LAYER section you need to set 3 SYMBOL

attributes. NAME "circle"
TYPE ellipse
• CONNECTIONTYPE has to be set to "PostGIS" FILLED true
• CONNECTION has to be set to the connection POINTS
string needed for PostGIS 11
• DATA has to be set with a SQL select to the END
geometry column from the layer table END

LAYER
The connection string needs some attribute to be set:
CONNECTIONTYPE postgis
CONNECTION "host=localhost
• HOST hostname of the PostgreSQL server dbname=TUTORIAL user=psqluser password=psqluser
• DBNAME name of the database where your port=5432"
PostGIS data are stored DATA "the_geom FROM compfun"
• USER name of the user NAME "compfun"
• PASSWORD TYPE POLYGON
• PORT you can omit this attribute if you installed STATUS ON
PostgreSQL at the default port (5432) CLASS
STYLE
Also for PostGIS layers, as for shapefile layers, NAME COLOR 255 235 190
can be anything. It is how you want to call the layer in OUTLINECOLOR 0 0 0
the MapServer context. SYMBOL 0
END
END
LAYER
END
CONNECTIONTYPE postgis
CONNECTION "host=localhost dbname=TUTORIAL
LAYER
user=psqluser password=psqluser port=5432"
NAME "zone"
DATA "the_geom FROM compfun"
CONNECTIONTYPE postgis
NAME "compfun"
CONNECTION "host=localhost
TYPE POLYGON
dbname=TUTORIAL user=psqluser password=psqluser
STATUS ON
port=5432"
CLASS
DATA "the_geom FROM zone"
STYLE
TYPE POLYGON
COLOR 255 235 190
STATUS ON
OUTLINECOLOR 0 0 0
CLASSITEM "COD"
SYMBOL 0
LABELITEM "NUMLOTT"
END
CLASS
END
EXPRESSION ([COD]=103)
END
STYLE
COLOR 230 50 0
Modify the MapFile tutorial's file OUTLINECOLOR 0 0 0
SYMBOL 0
You can use the csharptutorial_postgis.map MapFile END
included with the tutorial data. END
CLASS
Or if you prefer you can copy the following text in a new EXPRESSION ([COD]=105 OR [COD]=106
text file named csharptutorial_postgis.map. OR [COD]=107 OR [COD]=108 OR [COD]=102)
STYLE
COLOR 255 235 230
13
 OUTLINECOLOR 0 0 0 COLOR 255 0 0
SYMBOL 0 FONT verdana
END TYPE TRUETYPE
LABEL SIZE 7
COLOR 0 0 0 POSITION LC
FONT verdana WRAP " "
TYPE TRUETYPE END
SIZE 7 END
POSITION CC END
END
END END
CLASS
EXPRESSION ([COD]=109 OR [COD]=101) In the next step you will adapt the c# to work indifferently
STYLE with shapefile or PostGIS data.
COLOR 255 196 171
OUTLINECOLOR 0 0 0
SYMBOL 0
END
END
CLASS
STYLE
COLOR 225 225 225
OUTLINECOLOR 0 0 0
SYMBOL 0
END
END
END

LAYER
CONNECTIONTYPE postgis
CONNECTION "host=localhost
dbname=TUTORIAL user=psqluser password=psqluser
port=5432"
DATA "the_geom FROM vestizioni"
NAME "vestizioni"
TYPE LINE
STATUS ON
CLASS
STYLE
COLOR 0 0 0
SYMBOL 0
END
END
END

LAYER
CONNECTIONTYPE postgis
CONNECTION "host=localhost
dbname=TUTORIAL user=psqluser password=psqluser
port=5432"
DATA "the_geom FROM poi"
NAME "POI"
TYPE POINT
STATUS ON
LABELITEM "POI_TIME"
CLASS
SIZE 10
STYLE
COLOR 255 0 0
OUTLINECOLOR 0 0 0
SYMBOL "circle"
END
TEXT ([POI_USER], [POI_TIME])
LABEL
14