4.7.1. Utilisation de base

Pour utiliser PostGIS avec Mapserver vous aurez besoin de savoir comment configurer Mapserver, ce qui dépasse le cadre de cete documentation. Cette section va couvrir les particularités d'une utilisation avec Postgis et les détails de la configuration.

Pour utiliser PostGIS avec Mapserver, vous aurez besoin de :

• La version 0.6 ou supérieure de PostGIS.
• La version 3.5 ou supérieure de Mapserver.

Mapserver accède aux données PostgreSQL/PostGIS comme n'importe quel autre client PostgreSQL - c'est à dire en utilisant la libpq. Cela signifie que Mapserver peut être installé sur chaque machines ayant un accès réseau vers un serveur PostGIS, temps que le système possède la libraire client de PostgreSQL (libpq).

1. Compilez et installez Mapserver, avec les supports qui vous souhaitez activer, incluant l'option de configuration : "--with-postgis".
2. Dans votre fichier map de Mpaserver, ajouté une couche PostGIS. Par exemple :
   
   LAYER
     CONNECTIONTYPE postgis
     NAME "widehighways"
     # Connect to a remote spatial database
     CONNECTION "user=dbuser dbname=gisdatabase host=bigserver"
     # Get the lines from the 'geom' column of the 'roads' table
     DATA "geom from roads"
     STATUS ON
     TYPE LINE
     # Of the lines in the extents, only render the wide highways
     FILTER "type = 'highway' and numlanes >= 4"
     CLASS
       # Make the superhighways brighter and 2 pixels wide
       EXPRESSION ([numlanes] >= 6)
       COLOR 255 22 22
       SYMBOL "solid"
       SIZE 2
     END
     CLASS
       # All the rest are darker and only 1 pixel wide
       EXPRESSION ([numlanes] < 6)
       COLOR 205 92 82
     END
   END
   
   

   Dans l'exemple ci-dessus, les directives spécifiques à PostGIS sont les suivantes :

   CONNECTIONTYPE
   Pour les couches PostGIS, cela sera toujours "postgis".

   CONNECTION
   La connection à la base de données est gouvernée par "la chaine de charatères de connection" ("connection string") qui est contituée d'un ensemble de couples nom/valeur comme ceci (avec la valeur par défaut entre < >) :
   user=<nom_d_utilisateur> password=<mot_de_passe> dbname=<nom_de_la_base_de_données> hostname=<serveur> port=<5432>
   Une chaine de charactères de connection vide reste valide, et chacun des couples nom/valeur peut être omis. Au minimum vous aurez généralement besoin de spécifier le nom de la base de données et le nom d'utilisateur avec lequel vous souhaitez vous connecter.

   DATA
   La forme de ce paramètre est : "<colonne> from <nom_de_la_table>" où la colonne est une colonne spatiale qui doit être affiché sur la carte.

   FILTER
   Le filtre doit être une chaîne de charactères SQL valide correspondant à la logique normale suivant le mot clef "WHERE" dans les requêtes SQL. Donc, par exemple, pour afficher uniquement les routes ayant 6 voies ou plus, utilisé le filtre "nombre_de_voies >= 6".

3. Dans votre base de données spatiale, assurez vous que vous avez des indexes spatiaux (GiST) pour chaque couches que vous souhaitez afficher.
   
   CREATE INDEX [nom_de_l_index]
   ON [nom_de_la_table]
   USING GIST ( [colonne_géometrique] GIST_GEOMETRY_OPS );
4. Si vous allez interroger vos couches en utilisant Mpaserver vous aurez aussi besoin d'un "index oid".
   Mapserver requière des indentifiants uniques pour chaque enregistrement spatial lorsque vous souhaitez effetuer des interrogations, et le module PostGIS de Mapserver utilise les valeurs d'oid de PostgreSQL pour fournir ces identifiants uniques. Cela implique comme effet de bord que si vous souhaitez effectuer des accès aléatoires rapides aux enregistrements durant les requêtes, un index sur les oid est necessaires.
   Pour construire un tel index, utilisez la requête SQL suivante :
   
   CREATE INDEX [nom_de_l_index] ON [nom_de_la_table] ( oid );