documentation

Les services WMS (Web Map Service) permettent de mettre à disposition d’utilisateurs distants des images géoréférencées, via une simple requête HTTP, à partir de données sources raster (image) ou vecteur.

WMS est un protocole standard défini par l’OGC (Open Geospatial Consortium) reconnu par une norme ISO. On peut consulter le document de référence sur le site de l’OGC.

Le Géoportail propose deux services d’image implémentant le protocole WMS, l’un pour les données Géoportail, l’autre pour les données aux standards INSPIRE. Pour chacun, il y a un chemin d’accès distinct selon que la donnée est issue de données image (raster) ou vectorielles.

Les services WMS INSPIRE délivrent les ressources WMS INSPIRE, les services WMS Géoportail délivrent les ressources WMS Géoportail.

Le chemin d’accès r ou v indique l’origine de la données (raster ou vecteur).

Le paramètre CLEF doit être remplacé par votre clé personnelle ou par celle définie dans une URL d'accès libre aux services web.

Les serveurs WMS Géoportail répondent aux trois types de requêtes WMS suivantes :

- GetCapabilities : renvoie les paramètres du service et les couches (une couche WMS correspond à une ressource) disponibles avec les informations permettant de paramétrer les requêtes suivantes ;

- GetMap : renvoie une image de la carte ;

- GetFeatureInfo : renvoie des informations sur les objets ayant servi à générer la carte (optionnelle).

La fonctionnalité GetFeatureInfo n’est pas supportée par toutes les ressources. Cela est indiqué couche par couche dans le document de réponse à la requête GetCapabilities.

• Exemples de requêtes WMS

Les images sont générées à la demande sur le serveur. En cas de données vecteur (couches de bâtiments, de limites administratives…), celles-ci sont rastérisées pour chaque emprise selon une légende prédéterminée.

• Paramètres disponibles

Les paramètres qui peuvent être utilisés dépendent de la requête soumise (GetCapabilities, GetMap, GetFeatureInfo). Ils peuvent être communs ou spécifiques, obligatoires ou optionnels. Les principaux paramètres utilisés sont les suivants (liste non exhaustive) :

Paramètres communs

• SERVICE : le type du service (ici “WMS”)
• VERSION : la version du service utilisée (1.1.1, 1.3…)
• REQUEST : la requête adressée au serveur (GetCapabilities, GetMap ou GetFeatureInfo)

NB : les services WMS du Géoportail supportent les versions 1.1.1 et 1.3.0 du protocole WMS.

Paramètres spécifiques GetMap

• FORMAT : le format de sortie - type-mime - du fichier image (“image/png”, “image/jpg”, …) ;
• LAYERS : la ou les ressources à utiliser pour calculer l’image. C’est le nom technique de la ressource qui est utilisé ;
• STYLES : le style de rendu des couches ;
• WIDTH : largeur de l’image finale en pixels ;
• HEIGHT : hauteur de l’image finale en pixels ;
• En WMS 1.0 WMS 1.1 et WMS 1.2, le paramètre SRS (Spatial Reference Système) et en WMS 1.3 le paramètre est renommé CRS. Ce paramètre indique le système de coordonnées utilisé ;
• BBOX (Bounding Box) : l’emprise géographique des données à rendre dans l’image.
• DPI : densité de l’image attendue en “dot per inch” ou “pixel par pouce” (par défaut : 90,7 DPI).

Paramètres spécifiques GetFeatureInfo

Une requête GetFeatureInfo reprend les paramètres permettant de créer une image et rajoute les paramètres suivants indiquant un point dans l’image et le format à utiliser pour retourner la réponse.

• I : abscisse d’un point dans l’image en pixels
• J : ordonnée d’un point dans l’image en pixels
• QUERY_LAYERS : la ou les ressources dont on veut récupérer les informations. C’est le nom technique de la ressource qui est utilisé ;
• INFO_FORMAT : le format de sortie - type-mime - de la requête GetFeatureInfo (ex : text/plain, text/html, ….)

• Ressources disponibles

On peut en obtenir la liste des ressources disponibles à l’aide d’une requête GetCapabilities sur chacun des services.

• Formats d’images disponibles

Les images retournées par le service WMS sont au format choisi par l’utilisateur à l’aide du paramètre FORMAT. Les formats possibles sont :

• JPEG (image/jpeg)
• PNG (image/png)
• TIFF (image/tiff)
• GeoTIFF (image/geotiff)

Dans le cas des services WMS issus de vecteur, les formats suivants sont également disponibles :

• GIF (image/gif)
• SVG (image/svg+xml)

• KML (application/vnd.google-earth.kml+xml)

• … d’autres formats de sortie peuvent être obtenus pour l’opération GetMap ; la liste complète est consultable dans le document de réponse à la requête GetCapabilities du service concerné (cf. adresses ci-dessus).

La taille maximale d’une image pouvant être retournée de 2048 x 2048 pixels (paramètres WIDTH et HEIGHT).

• Résolution – Niveaux de zoom

La notion de niveau de zoom n’est pas pertinente dans le protocole WMS. Néanmoins, selon l’emprise demandée, la représentation et les données appelées peuvent varier.

• Projections

Les services WMS de la plateforme Géoportail peuvent servir des images dans différents systèmes de références de coordonnées. La liste de ceux disponibles est consultable dans le document de réponse à la requête GetCapabilities du service concerné (cf. adresses ci-dessus).

NB : Pour les services de WMS INSPIRE, ne sont proposées que les projections EPSG:4258, CRS:84 et les projections géographiques des départements ou régions français d’Outre-Mer (DROMs).

• Styles

Des styles par défaut sont appliqués pour générer les images lors d’une requête GetMap. Certaines ressources peuvent être affichées avec des plusieurs styles (au choix de l’utilisateur) que l’on renseigne via le paramètre STYLES . La liste des styles disponibles pour une ressource est renseigné dans le document de réponse à la requête GetCapabilities du service concerné .