Spécifications WMS¶
La spécification WMS définit une interface HTTP pour interroger des données géo-référencées et récupérer des cartes graphiques mises en forme à partir de ces données. Le service propose des opérations distinctes pour interroger les différentes composantes du service (erreurs, métadonnées, images, données, légendes cartographiques).
Opérations¶
Exceptions : Si une erreur intervient dans la réponse, cette opération permet de l’intercepter dans
un format spécifié par l’utilisateur.
GetCapabilities : Renvoie les métadonnées du service. Cela comprend principalement les
opérations et paramètres autorisés pour le service.
GetMap : Renvoie une image cartographique d’une ressource pour une zone déterminée.
GetFeatureInfo : Renvoie les données d’une entité cartographique, dont les géométries et valeurs
attributaires, en fonction de la localisation d’un pixel. Pour une source de données raster, renvoie
la valeur de la maille.
GetLegendGraphic : Renvoie la légende générée pour une carte, en fonction du style associé à la
carte.
Exceptions (WMS)¶
Il s’agit d’une opération associée aux opérations GetCapabilities, GetMap et GetFeatureInfo. En cas d’erreur pour ces dernières, « exception » renvoie l’erreur dans le format voulu. Les valeurs suivantes sont acceptées :
Format |
Syntaxe |
Notes |
|---|---|---|
XML |
EXCEPTIONS=application/vnd.ogc.se_xml |
Sortie XML (par défaut) |
INIMAGE |
EXCEPTIONS=application/vnd.ogc.se_inimage |
Génère une image |
BLANK |
EXCEPTIONS=application/vnd.ogc.se_blank |
Génère une image vide |
PARTIALMAP |
EXCEPTIONS=application/vnd.gs.wms_partial |
Paramètre spécifique à GeoServeur (non OGC). Renvoie toute l’image générée jusqu’à l’arrivée de l’exception |
JSON |
EXCEPTIONS=application/json |
Représentation JSON simple |
JSONP |
EXCEPTIONS=text/javascript |
Renvoie un JsonP de la forme suivante : paddingOutput(…jsonp…) |
GetCapabilities (WMS)¶
L’opération GetCapabilities renvoie les métadonnées concernant les opérations, services et
données offertes par un serveur WMS.
Paramètre |
Obligatoire |
Description |
|---|---|---|
service |
Oui |
Nom du service. Valeur à WMS |
version |
Oui |
Version du service. Valeurs possibles : 1.0.0, 1.1.0, 1.1.1, 13 |
request |
Oui |
Nom de l’opération. Valeur à GetCapabilities. |
La réponse est un document XML des capacités du service WMS.
Il contient 3 sections principales :
Service : Contient les métadonnées du service, comme son nom, ses mots-clés, les informations sur le point de contact et l’organisation qui gère le serveur.
Request : Déscription des opérations que le WMS fournit et les paramètres et formats de sortie pour chaque opération.
Layer : Liste des systèmes de coordonnées et couches disponibles. Les couches sont nommées selon un paramètre : « layer : couche ».
GetMap (WMS)¶
L’opération GetMap interroge le serveur pour qu’il génère une carte. Les paramètres principaux
spécifient la ou les couches voulues, les styles appliqués à la carte, la zone d’étendue de la
carte, le système de projection, la taille de l’image en sortie et son format. Les valeurs possibles
pour les paramètres comme layers, styles ou srs peuvent être obtenus à partir du document issu
de l’opération GetCapabilities.
La réponse est une image cartographique, dans le format spécifié par le client :
Format |
Syntaxe |
Détail |
|---|---|---|
PNG |
format=image/png |
Par défaut |
PNG8 |
format=image/png8 |
Identique à PNG, mais calcule une palette optimisée sur 256 couleurs (8bits), afin de minimiser la taille du fichier image généré |
JPEG |
format=image/jpeg |
|
GIF |
format=image/gif |
|
TIFF |
format=image/tiff |
|
TIFF8 |
format=image/tiff8 |
Identique à TIFF, mais calcule une palette optimisée sur 256 couleurs (8bits), afin de minimiser la taille du fichier image généré |
GeoTIFF |
format=image/geotiff |
Identique à TIFF mais génère les métadonnées de localisation |
GeoTIFF8 |
format=image/geotiff8 |
Identique à TIFF mais génère les métadonnées de localisation ainsi qu’une palette optimisée sur 256 couleurs (8bits) |
SVG |
format=image/svg |
|
format=application/pdf |
||
GeoRSS |
format=rss |
|
KML |
format=kml |
|
KMZ |
format=kmz |
Les paramètres standards pour l’opération GetMap :¶
Paramètre |
Obligatoire |
Description |
|---|---|---|
service |
Oui |
Nom du service. La valeur est WMS |
version |
Oui |
Version du service. Valeurs possibles : 1.0.0, 1.1.0, 1.1.1, 1.3 |
request |
Oui |
Nom de l’opération. Valeur à GetMap |
layers |
Oui |
Couches à afficher sur la carte. La valeur est une liste de couches séparées pas des virgules |
styles |
Oui |
Styles dans lesquels les couches seront générées. La valeur est une liste de styles séparés pas des virgules, ou vide si le style par défaut est souhaité |
srs or crs |
Oui |
Système de coordonnées pour l’image en sortie. La valeur doit être dans le format EPSG:nnn. Si la version du service est WMS 1.3.0, alors le nom de paramètre utilisé doit être crs |
bbox |
Oui |
Rectangle englobant pour l’étendue géographique souhaitée. La valeur est minx,miny,maxx,maxy dans l’unité du système de coordonnée de la carte |
width |
Oui |
Largeur de la carte générée, en pixels |
height |
Oui |
Hauteur de la carte générée, en pixels |
format |
Oui |
Format de sortie de la carte. Voir la liste des formats supportés |
transparent |
Non |
Transparence des valeurs du fond (background value). Valeur par défaut : false |
bgcolor |
Non |
Couleur de fond pour l’image. Format des valeurs : RRGGBB. Valeur par défaut : FFFFFF (blanc) |
exceptions |
Non |
Format dans lequel sont renvoyées les exceptions. La valeur par défaut est application/vnd.ogc.se_xml |
time |
Non |
Valeur temporelle ou intervalle pour les données cartographiques |
sld |
Non |
URL qui référence un fichier de description de style (sld) externe qui sera appliqué aux couches de la carte |
sld_body |
Non |
SLD encodé dans une URL qui sera appliqué aux couches de la carte |
GetFeatureInfo (WMS)¶
Cette opération permet de récupérer l’information correspondant à une maille de l’image en
fonction de la localisation d’un pixel. Il s’agit d’une opération qui se base sur un GetMap
dans le sens où une image est générée selon les spécifications de GetMap et la récupération de
la valeur se fait en fonction de la localisation d’un pixel dans l’image générée.
Paramètre |
Obligatoire |
Description |
|---|---|---|
service |
Oui |
Nom du service. La valeur est WMS |
version |
Oui |
Version du service. Valeurs possibles : 1.0.0, 1.1.0, 1.1.1, 1.3 |
request |
Oui |
Nom de l’opération. Valeur à GetMap |
layers |
Oui |
Couches à afficher sur la carte. La valeur est une liste de couches séparées pas des virgules. |
styles |
Oui |
Styles dans lesquels les couches seront générées. La valeur est une liste de styles séparés par des virgules, ou vide si le style par défaut est souhaité. |
srs or crs |
Oui |
Système de coordonnées pour l’image en sortie. La valeur doit être dans le format EPSG:nnn. Si la version du service est WMS 1.3.0, alors le nom de paramètre utilisé doit être crs. |
bbox |
Oui |
Rectangle englobant pour l’étendue géographique souhaitée. La valeur est minx,miny,maxx,maxy dans l’unité du système de coordonnée de la carte. |
width |
Oui |
Largeur de la carte générée, en pixels |
height |
Oui |
Hauteur de la carte générée, en pixels |
info_format |
Non |
Format de sortie de l’information (voir tableau suivant). |
query_layers |
Oui |
Couches recherchées, plusieurs peuvent être spécifiées (séparateur virgule) |
feature_count |
Non |
Nombre d’objets renvoyés dans la réponse. Par défaut 1. |
x |
Oui |
Localisation en abscisse du pixel recherché |
y |
Oui |
Localisation en ordonnée du pixel recherché |
Time |
Non |
Paramètre temporel |
Exceptions |
Non |
Format dans lequel les erreurs sont récupérées. La valeur par défaut est application/vnd.ogc.se_xml |
Formats de réponse (info_format) :¶
Format |
Syntaxe |
Détail |
|---|---|---|
TEXT |
Info_format=text/plain |
Par défaut, réponse en texte préformaté. |
GML 2 |
info_format=application/vnd.ogc.gml |
Format GML 2 |
GML 3 |
info_format=application/vnd.ogc.gml/3.1.1 |
Format GML 3 |
HTML |
info_format=text/html |
Utilise un modèle HTML qui est défini par le serveur. |
JSON |
info_format=application/json |
Représentation Json simple |
JSONP |
Info_format=text/javascript |
Renvoie un JsonP dont le callback est parseResponse |
GetLegendGraphic¶
Cette opération envoie la légende du style associé à une couche.
Paramètre |
Obligatoire |
Description |
|---|---|---|
version |
Oui |
Version du service. Valeurs possibles : 1.0.0, 1.1.0, 1.1.1, 1.3 |
format |
Oui |
format=image/png par défaut |
width |
Oui |
Largeur (pixels) |
height |
Oui |
Hauteur (pixels) |
layer |
Oui |
Couche |
