Version 1.4 Note sur la création de la base de données géographique et la configuration du module SVG Par JC Desconnets jcd@teledetection.fr Montpellier Décembre 2006
Préambule : Cette note donne les opérations nécessaires pour créer une nouvelle base de données géographique et y insérer les couches vecteurs (shapefile) utilisées dans le module cartographique SVG de MDweb. Elle donne aussi les éléments pour le paramétrage du module cartographique SVG, notamment le choix des couches à afficher, la taille de la fenêtre SVG. Quelques rappels Utilité et utilisation de la base de données géographiques pour le module cartographique SVG La base de données géographique qui est associée à MDweb héberge les couches d informations géographiques que l on souhaite visualiser dans le module de recherche et de saisie cartographique SVG. Ces couches d information au sein du module SVG sont le support : lors de la saisie d une fiche de métadonnées, donné à l utilisateur pour définir l emprise géographique et le toponyme du jeu de données qu il décrit et, en consultation, le moyen de définir une zone ou un toponyme sur lequel il souhaite faire porter sa recherche de données. Pour proposer à l utilisateur tant en saisie qu en recherche les objets géographiques pertinents, il est nécessaire de définir un ensemble de couches d information représentant les objets géographiques d intérêt du projet de catalogage sur lesquels pourront être référencés les jeux de données. A travers, son module de création et de gestion de la base de données géographique, MDweb permet lors de la mise en place de l outil, de créer une base de données, insérer les couches d informations sans avoir une connaissance de système de gestion PostgreSQL/PostGIS, puis de configurer en partie le module cartographique SVG. Limites actuelles Limites pour la construction de la base de données La création de la base de données géographiques doit être réalisée à partir de fichiers de forme (ou couche vecteur) au format shape d ESRI sur des données géoréférencées dans un système de projection. Les fichiers shapes doivent être accompagnés de leur fichier de définition de projection *.proj. Par ailleurs, afin de permettre une certaine fluidité lors du chargement du module SVG et lors des opérations effectuées dessus (zoom, sélection, etc.), il est préférable d insérer des couches d informations dont le nombre d objets est limité (entre 200 et 500) et d une complexité réduite. Le temps nécessaire au chargement du flux XML alimentant le module SVG est bien entendu fonction du débit de connexion. Mais il faut garder à l esprit que le module cartographique de MDweb n est pas un module de navigation et de visualisation détaillée mais bien un support à la saisie d emprise spatiale et à la recherche de données par localisation. Ces deux dernières fonctions nécessitent bien de considérer les objets d intérêts nécessaires mais de rend pas indispensable une précision de représentation très élevée. Page 2 sur 19
Limites du module de gestion de la base de données géographiques La base de données géographiques est construite en s appuyant sur PostgreSQL/PostGIS. Lors de la création ou de la modification de la base de données géographiques, le serveur hébergeant MDweb et le serveur hébergeant la base de données doit être le même. Par, aileurs, les bilbliothèques GEOS et PROJ4 doivent être installées ainsi que l exécutable proj et invproj. En effet, les scripts qui assurent la création, la modification de la base de données sont réalisés par l exécution des commandes du client postgres (psql, createdb, dropdb, shp2psql, etc.) à travers les scripts PHP. Le module a été implémentée et tester uniquement sur PostgreSQL/Postgis 8.1 sous Windows et 7.4 sous Linux. Il permet d insérer uniquement des fichiers shape projetés (utilisation de la fonction shp2psql). Du fait de l exécution des fonctions PostgreSQL par PHP, le temps d exécution des commandes postgres est tributaire de la directive php.ini max_execution_time que l on doit régler à 180 s. Pour cela, l insertion de fichier shape volumineux risque d être problématique. Accès au module de gestion de la base de données géo L accès au module de gestion de la base de données géographique n est possible que si vous êtes loggé dans MDweb en tant qu administrateur. Vous devez accéder au module d administration de MDweb. L ensemble des fonctionnalités du module sont accessibles par l élément BD Géo du menu administrateur Le module de gestion de la base de données géographiques propose cinq grandes fonctions : Ajouter : pour créer une nouvelle base de données géographiques Modifier : pour insérer ou supprimer des couches d information dans une base de données géographique existante Supprimer une base de données géographique Configuration de la connexion : assure le paramétrage de la connexion à un serveur PostgreSQL et à une base de données géographique qui sera utilisée pour le module cartographique SVG Configuration du module SVG : création ou modification du fichier get_capabilities.xml nécessaire au module cartographique pour gérer les couches d informations souhaitées dans le module SVG. Page 3 sur 19
Création d une base de données géographique Ce module permet de créer une nouvelle base de données géographique sous PostgreSQL/PostGIS. Pour permettre, l utilisation de ce module, la cartouche spatiale PostGIS doit être installée sur votre serveur PostgreSQL. Lors de la création d une base de données géographique, les scripts MDweb exécutent les commandes de création suivantes : - creatdb - plpgsql - psql et utilisent les fichiers lwpostgis.sql, spatial_ref_sys.sql de PostGIS. Table créées et utilité Les tables créées dans la base de données géographiques. Par défaut, lors de la création d une base de données hébergeant des objets géographiques de type GEOM, PostgreSQL créée deux tables : geometry_column qui référence toutes les tables comportant de la géométrie (champ de type GEOM) et leurs caractéristiques spatial_ref_sys qui contient la définition des systèmes de projection. Pour les besoins de MDweb, trois autres tables sont créées : objet_geom : qui contient les objets géographiques servant à la définition des emprises des fiches de métadonnées de votre catalogue metadata_link : table qui permet de faire le lien entre les identifiants des fiches de métadonnées et les emprises (géométrie) stockées dans la table objet_geom hierarchiespatiale (pas implémentée pour le moment) : table permettant de stocker la hierarchie entre les couches contenues dans la base géographique. Cette hierarchie sera utilisée pour visualiser les couches d information dans le module cartographique. Création de la base de données à partir du module BD Géo de MDweb 1. Accédez à la page Ajouter une base de données géographique à partir du menu du module administration Page 4 sur 19
2. Compléter le formulaire proposé en contrôlant la validité des valeurs par défaut. Si ces valeurs ne conviennent pas, vous pouvez les modifier afin de permettre la bonne exécution de la création. Il faudra dans une deuxième étape, modifier la configuration par défaut de la connexion à la base de données géographiques en allant à la page Connexion à la BD Géo du même module. 7 champs sont proposés pour permettre la création de la base de données : Adresse IP du SGBD : Nom ou adresse IP du serveur hébergeant la base de données géographique. Port TCP/IP du SGBD : Numéro du port d accès au serveur de base de données. Par défaut, le port est 5432. Compte utilisateur : Nom de l utilisateur pouvant accéder à la base de données géographique. Il doit avoir les droits en écriture sur la base de données. Il doit aussi pouvoir créer une base de données. Mot de passe : Mot de passe de l utilisateur. Nom de la base de données géographique : vous devez choisir un nom qui ne comporte pas d espace, ni de caractères spéciaux (? ; :! & etc.) Chemin absolu du fichier lwpsotgis.sql : le chemin absolu doit comporter le nom du lecteur pour une installation Windows. Normalement, ce fichier se trouve dans le répertoire share/contrib/ de votre installation PostgreSQL. Si ce n est pas cela signifie que la cartouche spatiale PostGIS n est pas installée. Ce fichier est strictement nécessaire à la bonne exécution des scripts de création. Chemin absolu du fichier spatial_ref_sys.sql : chemin absolu doit comporter le nom du lecteur pour une installation Windows. Normalement, ce fichier se trouve dans le répertoire share/contrib/ de votre installation PostgreSQL. Ce fichier est strictement nécessaire à la bonne exécution des scripts de création. 3. Après avoir compléter, Envoyer le formulaire, une nouvelle page apparaît pour finaliser la création de la base de données géographique. Page 5 sur 19
4. choix du srid ou identifiant du système de projection. Vous devez donner le srid du système de projection utilisé. Il s agit d un identifiant numérique unique. Ils sont définis dans la table spatial_ref_sys de votre base de données. a) Le champ identifiant du système de référence vous permet d accéder à la liste des srid stockés et de choisir celui qui est approprié (le même que celui de votre fichier *.proj). En cliquant sur un des élément de la liste, vous compléter automatiquement les deux champ identifiant du système de référence.. et description du système.. Ou b) charger le fichier de définition de projection de votre fichier shape à partir du bouton parcourir c) envoyer le formulaire Page 6 sur 19
Aide à l identification du srid : le srid n est pas contenu dans le fichier de définition de votre shape, par contre, il contient le nom du système de projection Vous pouvez chercher le srid du système de projection sur le site de OGP Surveying & Positionning Commitee (www.epsg.org) rubrique EPSG Geodetic Parameter Dataset. Dans le cas, où votre système n est pas référencé dans par cette organisme, il en existe d autres dont ESRI, nous fournissons un fichier spatial_ref_sys.sql en téléchargement qui contient un complément de système. Une recherche textuelle avec le nom de votre système vous permettra sans doute trouver le srid correspondant dans ce fichier. Il est téléchargeable à l adresse : http://jc.desconnets.free.fr/mdweb/install/proj/srid.sql Modification d une base de données géographique 1. Accédez à la page Modifier la base de données géographique à partir du menu du module administration Insertion d une nouvelle couche d information géographique 2. cliquez sur le bouton Modifier pour accédez aux champs qui vous permettrons de charger le fichier shape et ses fichiers associés (shx, dbf) Page 7 sur 19
3. insérer les chemins du shapefile que vous souhaitez insérer dans la base. Trois fichiers sont nécessaires à l importation : Le fichier de forme shp Le fichier d index shx Le fichier contenant les attributs dbf. Note : Le fichier dbf doit présenter obligatoirement une colonne appelée toponyme de type text de 50 caractères maximum. Cette colonne est utilisées pour l affichage du toponyme. 4. Vous devez ensuite définir un nom pour la table qui sera créée dans la base de données. Ce nom de table sera ensuite utilisé pour paramétrer le module SVG (voir plus bas) notamment les fichiers layers.php, get_capabilities.xml. 5. Envoyez votre formulaire complété. Remarque : L insertion d une couche d information est permise pour une couche d information déjà projetée dans un système et accompagné de son fichier de définition de projection *.proj Page 8 sur 19
Suppression d une couche d information géographique La suppression d une table dans une base de données se fait par l intermédiaire de la même page que l insertion 1. Accédez à la page Modifier la base de données géographique à partir du menu du module administration 2. Choisir la base de données sur laquelle vous souhaitez réaliser la suppression 3. Supprimer la table que vous souhaitez. La suppression est définitive. Page 9 sur 19
Suppression d une base de données géographique 1. Accédez à la page Supprimer la base de données géographique à partir du menu du module administration 2. Choisir la base de données que vous souhaitez supprimer. 3. Valider. La suppression est définitive Configuration de la connexion à la base de données géographique Ce module assure le paramétrage de la connexion à un serveur PostgreSQL et à une base de données géographique qui sera utilisée pour le module cartographique SVG. Son exécution réécrit les valeurs des variables de connexion contenu dans le fichier config/config.inc.carto.php. Vous y accéder par l élément BD Géo > Configuration > Connexion BD Géo Vous accéder à un formulaire qui va vous permettre de modifier la configuration courante ou par défaut. Page 10 sur 19
7 champs permettent le paramétrage de la connexion à la base de données géographique : Adresse IP du SGBD : Nom ou adresse IP du serveur hébergeant la base de données géographique. Il peut être sur un autre serveur que celui utilisé pour la base de données mdweb-demo14 Port TCP/IP du SGBD : Numéro du port d accès au serveur de base de données. Par défaut, le port est 5432. Compte utilisateur : Nom de l utilisateur pouvant accéder à la base de données géographique. Il doit avoir les droits en écriture sur la base de données. Il doit aussi pouvoir créer une base de données. Mot de passe : Mot de passe de l utilisateur. Chemin du script d inversion de projection (invproj) : chemin de l exécutable d'inversion de projection. Par défaut, la valeur invproj.exe est proposé pour une installation sous Windows et /usr/local/bin/invproj sous Linux. Si vous donnez un chemin relatif pour accéder à cet exécutable, son chemin absolu doit être mis dans la variable PATH de votre système. Si ce n est pas le cas, sous Windows, vous devrez modifier votre variable système PATH et rédémarrer le serveur (OS Windows). Chemin du script de projection (proj) : chemin de l exécutable de projection. Par défaut, la valeur proj.exe est proposé pour une installation sous Windows et /usr/local/bin/proj sous Linux. Si vous donnez un chemin relatif pour accéder à cet exécutable, son chemin absolu doit être mis dans la variable PATH de votre système. Si ce n est pas le cas, sous Windows, vous devrez modifier votre variable système PATH et rédémarrer le serveur (OS Windows). Nom de la base de données géographique : une liste déroulante vous permet de choisir la base de données géographique présente sur votre serveur PostgreSQL sur laquelle sera utilisée le module cartographique SVG. Après modification et vérification des valeurs saisies dans les champs, valider avec le bouton création du fichier de configuration du module géographique Après cette opération, le fichier config/config.inc.carto.php sera modifié. Page 11 sur 19
Remarque : pour que cette opération s effectue correctement, il est indispensable que l utilisateur apache (utilisateur du service httpd) est les droits en écriture sur le répertoire où sont stockés les scripts de MDweb Page 12 sur 19
Configuration du module cartographique SVG Afin d adapter le module SVG à vos besoins des modifications sont nécessaires pour la configuration : du serveur WMS, notamment pour la configuration de la connexion de la base géographique et l adresse du serveur WMS du client SVG, notamment, les couches affichées à l initialisation du module et la taille de la fenêtre du module dans les pages MDweb. Modification de la configuration du serveur WMS (Web Map Server) 1. Modifications du fichier svg_carto/wms_server/config/wms.php Nom variable PHP commentaires Valeur par défaut WMS_PG_HOST Nom ou adresse IP du serveur localhost hébergeant la base de données géographique. WMS_PG_PORT Numéro du port d accès au serveur de 5432 base de données WMS_PG_USER Nom de l utilisateur pouvant accéder postgres à la base de données géographique. Il doit avoir les droits en écriture sur la base de données. Il doit aussi pouvoir créer une base de données WMS_PG_PASS Mot de passe de l utilisateur postgres WMS_PG_NAME Nom de la base de données geo-demo14 géographique. WMS_PGTHESO_NAME Nom de la base de données hébergeant thesaurus-fra les thésaurus. WMS_INVPROJ_PATH chemin de l exécutable d'inversion de projection invproj.exe (windows) /usr/local/bin/invpro j (Linux) WMS_PROJ_PATH chemin de l exécutable de projection proj.exe (windows) /usr/local/bin/proj (Linux) WMS_METADATA_LINK_TABLE Ne pas modifier metadata_link WMS_GEOMETRYCOLL_TABLE Ne pas modifier objet_geom WMS_USE_ZLIB Ne pas modifier true WMS_DP_SIMPLIFY Ne pas modifier 1 WMS_SERVICE_TITLE Ne pas modifier MDweb WMS_SERVICE_URL Adresse web du service cartographique SVG dans MDweb http://localhost/mdwe b- demo14/svg_carto/wms_ server WMS_SERVER_URL Adresse web du serveur WMS dans MDweb http://localhost/mdwe b- demo14/svg_carto/wms_ server/wms.php $application_path Chemin absolu du du module SVG dans MDweb /wamp/www/mdwebdemo14/svg_carto/ Page 13 sur 19
2. Modifications du fichier svg_carto/wms_server/config/layers.php Le fichier layers.php permet de définir les couches d information (table de la base de données géographique) qui peuvent être potentiellement affichées dans le module SVG. Par défaut, ce fichier contient la définition de trois tables qui sont données dans la base de données de démonstration (geo-demo14) : ocean, world, et objet_geom. La définition de la couche objet_geom doit toujours être présente car c est elle qui est utilisée pour afficher les emprises des fiches trouvées lors d une recherche. Lorsque vous souhaitez faire apparaître une autre couche d information qui est présente dans votre base de données, vous devez ajouter une entrée supplémentaire à la variable $layers comme ceci : "NAME" => array ( "title" => "TITLE", "style" => "STYLE", "rayon" => "RAYON", ), Où NAME est le nom de la table dans votre base de données TITLE le nom de la couche qui apparaîtra dans le module SVG STYLE le style d affichage de la couche. 200 styles sont proposés dans le fichier style.css du même répertoire. La valeur donnée ici doit être prise dans le fichier style.css RAYON est la dimension des points dans le cas d une couche d information de type POINT. La valeur varie de 1000 à 10000 selon l échelle de représentation. 3. Modifications du fichier svg_carto/wms_server/get_capabilities.xml Le fichier get_capabilities.xml est appelé par le module SVG lors de son initialisation pour afficher les couches définies dans le fichier svg_carto/wms_server/config/layers.php. Ce fichier doit être générer après avoir mis en place l ensemble des couches d information dans votre base de données et avoir correctement paramétrer le fichier svg_carto/wms_server/config/wms.php. Vous pouvez le générer et le modifier dans le module d administration de MDweb. Pour cela : 1. Accédez à la page Mise à jour du fichier get_capabilities (module SVG) à partir du menu du module administration Page 14 sur 19
2. Vérifiez le contenu du fichier généré par MDweb, notamment si : les adresses de votre service WMS sont exactes, les couches d information présentes et leur style selon les modifications effectuées dans le fichier layers.php. 3. Après vérification, envoyer le formulaire. Le fichier get_capabilities.xml est mis à jour. Tester le module SVG dans le module de recherche de MDweb. Remarque : Si des erreurs se présentent, il s agit le plus souvent : -D une mauvaise insertion des couches d information dans la base -D une configuration du fichier wms.php -D un ajout erroné dans le fichier layers.php Page 15 sur 19
Modification de la configuration du client SVG Deux types de fichiers sont à modifier : Les fichiers de configuration du client SVG wms_client/config.php et wms_client/config_carto.php, wms_client/wms_client.php et wms_client/wms_client_carto.php Les scripts de MDweb faisant appel au module SVG : wms_client/index.php et consult/consult.php 1. Les fichiers de configuration du client SVG config_carto.php et config.php Le fichier config.carto.php et config.php et ont le même usage. Il permettent de définir les couches affichées à l initialisation du module (sous ensemble des couches de get_capabilities.xml) et la taille du module SVG dans les pages MDweb. Le premier permet de paramétrer le module SVG dans la page de recherche cartographique, le second dans le formulaire de recherche multi-critères. Au moins, une variable est à modifier layers_to_display qui permet de définir le nom des couches à afficher (nom des tables). Si vous souhaitez modifier la taille de la fenêtre SVG, vous devez changer les valeurs des variables screen_width et screen_height. Vous devez faire les mêmes modifications dans le fichier config.php. les valeurs des variables screen_width et screen_height devront être plus faibles. Page 16 sur 19
2. Les fichiers de configuration du client SVG wms_client/wms_client.php et wms_client/wms_client_carto.php Si vous avez modifié la taille de la module d affichage SVG dans les fichiers config.carto.php et config.php, vous devez répercutez ces modifications dans les fichiers wms_client/wms_client.php et wms_client/wms_client_carto.php. Les valeurs de la variable viewbox doivent être égales à celles données dans les variables screen_width et screen_height. Attention de bien différencier les valeurs données dans les deux fichiers config.php et config_carto.php 3. Modification des scripts de MDweb faisant appel au module SVG : wms_client/index.php et consult/consult.php Ces deux scripts font appel au module SVG notamment à travers la balise <embed>. Le fichier wms_client/index.php est utilisé pour l affichage du module SVG de la recherche cartographique. Les valeurs des attributs width et height de la balise <embed> doivent être identique aux valeurs screen_width et screen_height du fichier wms_client/config_carto.php.. Page 17 sur 19
Le fichier consult/consult.php est utilisé pour l affichage du module SVG de la recherche multi-critères. Les valeurs des attributs width et height de la balise <embed> doivent être identique aux valeurs screen_width et screen_height du fichier wms_client/config.php. C est fini. Page 18 sur 19
Contacts IRD / US Désertification (US 166) 500, rue Jean François Breton, 34093 Montpellier Cedex 05 TEL : +33 (0)4 67 54 87 02 J.C Desconnets jcd@teledetection.fr Site du projet MDweb : www.mdweb-project.org Démonstrateur en ligne : www.mdweb-project.org/demo14/ Page 19 sur 19