http://data.lacub.fr 1

Utilisation des WebServices CUB

Objectif de ce document : Ce document montre comment utiliser les WebServices CUB WFS et WMS, disponibles sur le site http://data.lacub.fr. Le logiciel utilisé dans ce document est Quantum GIS, les WebServices CUB pouvant être utilisés par n’importe quel client WMS ou WFS.

Sommaire :

Utilisation des WebServices CUB ............................................................................................................ 1 

I.  Prérequis ..................................................................................................................................... 2 

I. 1.  Clé logicielle ......................................................................................................................... 2 

I. 2.  Logiciel client WMS / WFS ................................................................................................... 2 

II.  Utilisation du WMS ...................................................................................................................... 4 

II. 1.  Définition ............................................................................................................................. 4 

II. 2.  Ajout du WebService WMS CUB dans QGIS ........................................................................ 4 

II. 3.  Ajout de couches à la carte ................................................................................................. 6 

II. 4.  Limites du WMS ................................................................................................................... 7 

III.  Utilisation du WFS ................................................................................................................... 8 

III. 1.  Définition ............................................................................................................................. 8 

III. 2.  Ajout du WebService WFS CUB dans QGIS .......................................................................... 8 

III. 3.  Ajout de couches à la carte ............................................................................................... 10 

III. 4.  Visualisation des attributs des objets ................................................................................ 11 

III. 5.  Limites du WFS .................................................................................................................. 12 

IV.  Ça ne marche pas ! ................................................................................................................ 13 

http://data.lacub.fr 2

I. Prérequis

I. 1. Clé logicielle

Une clé logicielle est nécessaire pour l'utilisation des services suivants :

API CUB WebServices WMS WebServices WFS

La clé fournie à l’inscription est unique pour les services cités, et est associée à une entité ré utilisatrice. Elle est utilisée afin d’assurer la mise à jour de statistiques d’usage des WebServices et de l'API CUB en vue d’améliorer le service.

Afin de continuer ce document, vous devez posséder une clé logicielle délivrée par la CUB. Pour en obtenir une, rendez-vous sur la page suivante :

http://data.lacub.fr/key.php

I. 2. Logiciel client WMS / WFS

Pour nous connecter aux WebServices, nous utiliserons le logiciel libre et gratuit Quantum GIS (ou QGIS), dans la version 1.7. Téléchargez-le dans sa dernière version sur le site officiel, puis installez-le :

http://qgis.org/

Ouvrez QGIS. Celui-ci est disposé en trois grandes parties :

http://data.lacub.fr 3

La carte : c’est la zone sur laquelle vous naviguerez, et c’est ici que les données des couches (WMS, WFS, Shapefile…) vont s’afficher.

Les couches : il s’agit de la zone listant les couches que vous souhaitez voir apparaître sur la carte. À noter que l’ordre des couches dans cette liste correspond à l’ordre d’empilement des couches sur la carte : la couche la plus haute dans la liste des couches sera celle qui sera le plus « au-dessus » des autres sur la carte.

La barre d’outils : contient un certain nombre de boutons, permettant d’ajouter des couches sur la carte, ou de traiter et manipuler les données.

http://data.lacub.fr 4

II. Utilisation du WMS

II. 1. Définition

Le « Web Map Service » (WMS) est un standard OGC de service web qui permet de produire dynamiquement des cartes à partir de données géoréférencées. Ce service fournit une image référencée géographiquement représentant les données de la zone géographique précisée par l’application qui appelle ce service. Le WMS vous permet notamment de consulter la donnée avec la symbologie de la CUB. L'API CUB permet d'afficher des couches WMS.

Un WebService WMS n’est pas visualisable directement, avec un navigateur par exemple. Il nécessite un logiciel client, qui va pouvoir converser convenablement avec le serveur WMS. QGIS étant un client WMS, nous allons maintenant voir comment le configurer.

II. 2. Ajout du WebService WMS CUB dans QGIS

Dans la barre d’outils, cliquer sur le bouton « Ajouter une couche WMS » :

C’est dans cette fenêtre que nous allons ajouter le serveur WMS CUB. Nous ne ferons cette opération qu’une seule fois, car QGIS va sauvegarder notre paramétrage.

Cliquer sur le bouton « Nouveau » pour ajouter le serveur WMS CUB :

http://data.lacub.fr 5

Vous devez renseigner deux champs :

Nom : il s’agit du nom que vous allez donner à ce paramétrage dans QGIS. Ce nom n’a pas d’importance, il apparaîtra dans la liste des serveurs WMS de QGIS. Vous pouvez mettre « Serveur WMS CUB ».

URL : c’est ici que nous renseignons l’URL du serveur WMS. C’est ici aussi que nous mettons la clé logicielle demandée sur le site http://data.lacub.fr. Supposons que notre clé est « ABCDEFGH » (cette clé est fictive), nous devrons donc mettre dans ce champs : http://data.lacub.fr/wms?key=ABCDEFGH N’oubliez pas de remplacer ABCDEFGH par votre propre clé !

Laisser les autres champs vides et les cases à cocher décochées, puis faites OK.

La configuration que vous venez de paramétrer apparaît maintenant dans la liste déroulante des serveurs WMS. Cliquez sur « Connexion » afin de vous connecter au serveur :

http://data.lacub.fr 6

La liste des couches mises à disposition du serveur WMS doit s’afficher. Si ce n’est pas le cas et / ou que vous avez un message d’erreur, il se peut que vous ayez fait une erreur dans le paramétrage. Reprenez la configuration du serveur WMS depuis le début.

II. 3. Ajout de couches à la carte

Nous avons donc ici les couches WMS disponibles, rangées par thèmes.

Le WMS hérite des représentations (couleurs, épaisseur et style des traits) définies par la CUB. Il vous permet donc de créer un fond de plan rapidement pour vos applications, à partir d'une ou plusieurs couches de données. Pour créer votre fond de plan, sélectionner la ou les couches souhaitées puis cliquer sur « Ajouter » : vous obtiendrez votre fond de plan qui sera composée des couches que vous avez sélectionnées, regroupées dans une même couche. Ce fond de plan s'affichera rapidement, puisqu'une seule requête sera envoyée au serveur pour récupérer l'ensemble de ces données dans une seule couche.

Nous allons ajouter la couche FV_COMMU_S, alias « Limites de communes de la CUB », et FV_FLEUV_S, alias "Garonne et Dordogne", situées dans le thème « Filaire voies » :

1. Déroulez le thème FILAIRE_VOIE alias « Filaire voies » en cliquant sur le + à la gauche du thème, puis sélectionnez « FV_COMMU_S » et « FV_FLEUV_S » :

2. Avant de cliquer sur « Ajouter », nous allons changer la projection de la couche. En effet, le système de coordonnées par défaut dans QGIS est le WGS84 (coordonnées latitude / longitude que vous retrouvez par exemple dans les GPS) ; cependant, le système de coordonnées national en France est le RGF93. Les données étant nativement en RGF93 / CC45 à la CUB, il est préférable de les visualiser dans cette projection. Pour changer la projection, cliquez sur « Modification » dans le cadre « Systèmes de coordonnées de référence ». Dans la fenêtre qui s’ouvre, sélectionnez la projection « RGF93 / CC45 » puis faites « OK » :

3. Vous pouvez ensuite cliquer sur « Ajouter » pour ajouter la couche à la carte.

http://data.lacub.fr 7

Remarque : Attention à ne pas ajouter à la carte des couches ayant des projections différentes, sous peine de ne pas pouvoir les voir correctement.

Vous avez maintenant une carte avec les contours de communes CUB et les fleuves, dans une seule et même couche :

La navigation sur la carte se fait avec les outils suivants :

II. 4. Limites du WMS

Certaines couches WMS dans QGIS n’affichent rien. Il faut zoomer pour les voir. Cela est dû aux échelles limites d’apparition. En effet, les couches contenant un nombre important d’objets sont limitées à l’affichage, c’est-à-dire qu’au-dessus d’une certaine échelle, elles ne seront pas dessinées par le serveur, pour des questions de performance d’affichage.

http://data.lacub.fr 8

III. Utilisation du WFS

III. 1. Définition

Le « Web Feature Service » (WFS) est un standard OGC définissant l’interface d’un service d’accès aux données. Ce service fournit les données, organisées en « feature », de la zone géographique précisée par l’application qui appelle ce. Le WFS vous permet notamment de consulter les données associées à chaque objet graphique de la couche géographique (par exemple le nom des communes pour la couche limite de commune). L'API CUB permet d'afficher des couches WFS et d'accéder aux données attributaires des objets.

Le WFS, contrairement au WMS, permet de manipuler directement les données et les attributs. Il est l’outil idéal pour la création d’applications cartographiques, car il permet à l’application de disposer et d’afficher les données comme bon lui semble.

III. 2. Ajout du WebService WFS CUB dans QGIS

Dans la barre d’outils, cliquer sur le bouton « Ajouter une couche WFS » :

http://data.lacub.fr 9

C’est dans cette fenêtre que nous allons ajouter le serveur WFS CUB. Nous ne ferons cette opération qu’une seule fois, car QGIS va sauvegarder notre paramétrage.

Cliquer sur le bouton « Nouveau » pour ajouter le serveur WFS CUB :

Vous devez renseigner deux champs :

Nom : il s’agit du nom que vous allez donner à ce paramétrage dans QGIS. Ce nom n’a pas d’importance, il apparaîtra dans la liste des serveurs WFS de QGIS. Vous pouvez mettre « Serveur WFS CUB ».

URL : c’est ici que nous renseignons l’URL du serveur WFS. C’est ici aussi que nous mettons la clé logicielle demandée sur le site http://data.lacub.fr. Supposons que notre clé est « ABCDEFGH » (cette clé est fictive), nous devrons donc mettre dans ce champs : http://data.lacub.fr/wfs?key=ABCDEFGH N’oubliez pas de remplacer ABCDEFGH par votre propre clé !

Laisser les autres champs vides et les cases à cocher décochées, puis faites OK.

La configuration que vous venez de paramétrer apparaît maintenant dans la liste déroulante des serveurs WFS. Cliquez sur « Connexion » afin de vous connecter au serveur :

http://data.lacub.fr 10

La liste des couches mises à disposition du serveur WFS doit s’afficher. Si ce n’est pas le cas et / ou que vous avez un message d’erreur, il se peut que vous ayez fait une erreur dans le paramétrage. Reprenez la configuration du serveur WFS depuis le début.

III. 3. Ajout de couches à la carte

Nous avons donc ici les couches WFS disponibles sur le serveur. Contrairement au WMS, il n’y a pas de thèmes. Pour ajouter une couche à la carte, il s’agit simplement de la sélectionner en cliquant une fois dessus, puis de cliquer sur le bouton « Ajouter ».

Nous allons ajouter la couche FV_COMMU_S, alias « Limites de communes de la CUB ». Pour ce faire, sélectionnez « FV_COMMU_S » :

Vous pouvez ensuite cliquer sur « Ajouter » pour ajouter la couche à la carte.

Vous avez maintenant une carte avec les contours de communes CUB :

http://data.lacub.fr 11

La couleur peut différer sur votre QGIS, car celui-ci met une couleur de remplissage aléatoire pour chaque couche. En effet, le WFS étant uniquement vectoriel (c’est-à-dire une suite de coordonnées représentant les objets), c’est au client cartographique de se charger du dessin de la carte (alors que dans le cas du WMS, c’est le serveur qui dessine). Vous pouvez changer les couleurs en double cliquant sur l’icône en dessous du nom de la couche.

La navigation sur la carte se fait avec les outils suivants :

III. 4. Visualisation des attributs des objets

Pour visualiser les attributs des objets visibles sur la carte, sélectionnez l’outil « Identifier les entités ».

Cliquez ensuite sur un ou plusieurs objets de la carte, et ses attributs vont s’afficher dans une fenêtre :

http://data.lacub.fr 12

III. 5. Limites du WFS

Le WFS CUB est configuré pour rendre 10000 objets maximum par requêtes. Cela peut poser problème dans certains cas de figures :

Le client charge une seule fois tous les objets de la couche : c’est le cas de QGIS, ce qui veut dire que celui-ci ne pourra charger des couches ayant plus de 10000 objets. C’est pour cela que dans QGIS certaines couches que vous ajouterez à la carte n’afficheront rien.

Le client charge à chaque zoom les objets qui sont dans l’étendue de la vue : c’est le cas des clients JavaScript, comme l’API CUB. Dans ce cas-là, si la vue demandée contient moins de 10000 objets, le serveur va les envoyer au client. Si il y a en a plus de 10000, il n’en enverra aucun.

Sur les serveurs CUB, une seule couche par requête WFS est autorisée.

http://data.lacub.fr 13

IV. Ça ne marche pas !

Si vous avez fait plusieurs fois la procédure, et que cela ne fonctionne pas ou qu’il y a un problème, contactez-nous en décrivant le problème le plus précisément possible sur la page suivante :

http://data.lacub.fr/contact.php

Vos retours nous permettent d’améliorer le service !