Utilisation des WebServices CUB

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
1
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
2



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
3
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
4
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
5
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
6
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
7
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
http://data.lacub.fr
« Ajouter une couche WFS » :
8
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
9
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
10
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
les entités ».
« Identifier
Cliquez ensuite sur un ou plusieurs objets de la carte, et ses attributs vont s’afficher dans
une fenêtre :
http://data.lacub.fr
11
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
12
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 !
http://data.lacub.fr
13