Configurer - Principe

Le visualiseur cartographique mviewer consomme des données et des services servis par le web (flux OGC WMS/WFS/WMTS, services de géocodage…). La connexion et le paramétrage de ces services se fait dans un fichier de configuration pivot qui permet en outre de personnaliser l’application (titre, logo, feuille de style…).

Si aucune configuration n’est indiquée dans l’URL, c’est la configuration par défaut qui s’applique ( apps/default.xml).

Il est possible de créer n fichiers de configuration (config1.xml, config2.xml…) de façon à créer plusieurs applications thématiques à partir d’une seule instance mviewer. Pour appeler une configuration particulière, il suffit alors de rajouter le paramètre config dans l’url, exemple ?config=demo/geobretagne.xml .

Pour voir des exemples d’applications et de fichiers de configuration XML, rendez vous à cette page : démos.

En cliquant sur Code, vous accèderez au fichier XML et le le bouton Démo vous permet de visualisation l’application.

Structure du fichier de configuration

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <config>
 3     <application />
 4     <extensions>
 5     <mapoptions />
 6     <baselayers>
 7         <baselayer />
 8     </baselayers>
 9     <proxy />
10     <olscompletion />
11     <elasticsearch />
12     <searchparameters />
13     <themes>
14         <theme>
15             <layer />
16         </theme>
17     </themes>
18 </config>

Paramètres d’URL

Il est possible d’instancier un mviewer avec des paramètres de configuration transmis par URL

  • config : Fichier de configuration à charger ex: mviewer/?config=apps/mon_appli.xml.

  • # : Il s’agit d’un raccourci pour appeler une config présente dans le dossier apps. ex: mviewer/#mon_appli.

  • theme : Thème css à utiliser ex: ?theme=geobretagne pour charger le theme doit être dans css/themes/geobretagne.css.

  • wmc : liste des contextes OGC WMC (séparés par des virgules) à charger afin d’alimenter le panel de gauche ex : mviewer/?wmc=demo/hydro.wmc

  • popup : true ou false. Si true, la page d’aide configurée s’affiche.

  • lang : Langue à utiliser pour l’interface. Passer exemple ?lang=en.

  • mode : Mode d’affichage à utiliser (d - default, s - simplifié, u - ultrasimplifié). Le mode simplifié ne dispose pas du panneau des thématiques et le mode ultra simplifié ne dispose pas de la barre de navigation.

  • title : Titre à utiliser. Seulement exploité en mode défault et simplifié.

  • topics : Thèmes à filtrer à partir du fichier XML.

  • q et qtype: Rechercher une localité. Exemple pour centrer au démarrage la carte sur une adresse en utilisant la BAN (base adresse nationale) : mviewer/?q=71 rue dupont des loges Rennes&qtype=ban

  • addLayer : permet de charger automatiquement une couche WMS à partir d’un objet JSON. Voir la section addLayer (Outil d’ajout de données) ci-dessous pour les détails d’utilisation.

addLayer (Outil d’ajout de données)

L’outil d’ajout de données permet d’ajouter rapidement des couches à la carte depuis un service WMS ou une API features. Il peut être utilisé de deux manières :

  • depuis l’interface, en activant le bouton « Ajouter des données » dans le menu ;

  • automatiquement, via le paramètre d’URL addLayer pour charger une couche au démarrage de l’application.

Pour afficher le panneau d’ajout de données dans l’interface, il faut activer l’option dans la configuration de l’application :

<application addlayerstools="true" />

Le fichier XML peut également préciser un autre fichier JSON pour la liste des serveurs proposés par l’outil :

<application addlayerstools="true" addlayerconfig="apps/data/mes_flux.json" />

Dans un fichier de configuration, cette option active l’outil pour l’application concernée. Le fichier XML ne contient pas la définition des couches à charger ; il sert surtout à rendre l’outil disponible dans l’interface. Une fois l’outil activé, l’utilisateur peut choisir une couche depuis le panneau, ou bien une couche peut être ajoutée automatiquement au chargement de la carte grâce au paramètre d’URL addLayer.

Si aucun fichier n’est précisé, l’outil utilise par défaut le fichier demo/data/ogc_csw_server.json. Lorsque l’attribut addlayerconfig est défini, l’outil charge ce fichier à la place.

Le paramètre d’URL addLayer accepte un objet JSON encodé contenant les informations suivantes :

  • url : URL du service WMS à interroger ;

  • name : nom de la couche à charger (layername) ;

  • title : libellé affiché dans mviewer ;

  • filter : filtre optionnel à appliquer à la couche.

Exemple d’utilisation du paramètre addLayer :

&addLayer={%22url%22:%22https://www.geo2france.fr/geoserver/hdf_common/ows%22,%22name%22:%22Antennes__HdF_EnService_Agreg%22,%22title%22:%22Antennes_test%22}

Cet exemple charge automatiquement la couche Antennes__HdF_EnService_Agreg depuis le service WMS indiqué, avec le titre Antennes_test dans l’interface.

Paramètres d’URL utilisés pour les permaliens

  • x : Coordonnées x du centre de la carte dans le système de projection utilisé par l’application.

  • y : Coordonnées y du centre de la carte dans le système de projection utilisé par l’application.

  • z : Zoom de la carte (1 à 20).

  • lb : Identifiant de la couche de fond affichée.

  • c_[monparam] : Où mon param est l’identifiant du composant personnalisé ou de la couche personalisée. La valeur du paramètre peut ensuite être utilisée par le composant ou la couche concernée. exemple c_mycustomlayer=red,blue,green

  • Plus d’informations sur les permaliens « Outils additionnels » menu Partage de carte

Sections de configurations