Communication avec un service WMS dans un navigateur Web
Cette rubrique présente la procédure d'utilisation des paramètres URL pour communiquer avec un service WMS dans un navigateur Web.
Demande et réponse WMS
La ressource en ligne de chaque opération prise en charge par un serveur WMS conforme est une adresse URL (Uniform Resource Locator) HTTP, donc un service WMS peut être considéré comme un service REST (Representational State Transfer). Contrairement à un service Web standard, un client SOAP n'est pas nécessaire pour la consommation d'un service WMS et un navigateur Web constitue le client le plus simple. Vous pouvez obtenir les métadonnées de niveau service d'un service WMS, une carte de type image ou les valeurs attributaires d'une entité en envoyant une demande URL au serveur et en affichant les réponses correspondantes dans le navigateur sous forme de document XML ou d'image.
Vous trouverez ci-dessous quelques exemples de demandes et de réponses pour chaque opération prise en charge par un service WMS ArcGIS Server.
Demande WMS GetCapabilities
http://sampleserver1.arcgisonline.com/ArcGIS/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/WMSServer?service=WMS&request=GetCapabilities&version=1.3.0
Réponse XML
 |
Demande WMS GetMap
http://sampleserver1.arcgisonline.com/ArcGIS/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/WMSServer?VERSION=1.3.0&REQUEST=GetMap&CRS=CRS:84&BBOX=-178.217598,18.924782,-66.969271,71.406235&WIDTH=765&HEIGHT=360&LAYERS=0,1,2&STYLES=,,Symbolizer&EXCEPTIONS=application/vnd.ogc.se_xml&FORMAT=image/png&BGCOLOR=0xFFFFFF&TRANSPARENT=TRUE
Carte de réponse
 |
Demande WMS GetFeatureInfo
http://sampleserver1.arcgisonline.com/arcgis/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/WMSServer?REQUEST=GetFeatureInfo&SERVICE=WMS&VERSION=1.1.1&LAYERS=0&STYLES=default&FORMAT=image/png&BGCOLOR=0xFFFFFF&TRANSPARENT=TRUE&SRS=EPSG:4326&BBOX=-125.192865,11.2289864971264,-66.105824,62.5056715028736&WIDTH=1044&HEIGHT=906&QUERY_LAYERS=0&X=103&Y=462
Réponse XML
 |
Demande WMS GetStyles
http://myserver/arcgis/services/OGC/SanFrancisco/MapServer/WMSServer?Service=WMS&Request=GetStyles&Version=1.3.0&Layers=pizzastores,highways,blockgroups
Réponse XML
 |
Demande WMS GetLegendGraphic
http://myserver/arcgis/services/OGC/SanFrancisco/MapServer/WMSServer?Service=WMS&Request=GetLegendGraphic&Version=1.1.1&Layer=blockgroups&Style=population_dist&Format=image/png&Width=128&Height=64&transparent=false&bgcolor=0xffff00&SLD=http://zeon/resources/cr/CR53077/sld.xml
Graphique de légende de réponse
 |
Demande WMS GetMap avec le paramètre TIME
http://myserver/arcgis/services/OGC/Fire/MapServer/WMSServer?VERSION=1.3.0&REQUEST=GetMap&CRS=CRS:84&BBOX=-111.232092,43.910823,-109.455485,45.339498&WIDTH=626&HEIGHT=504&LAYERS=fire&STYLES=&EXCEPTIONS=application/vnd.ogc.se_xml&FORMAT=image/png&BGCOLOR=0xFFFFFF&TRANSPARENT=TRUE&TIME=1988-08-01T00:00:00/1988-08-11T00:00:00
Carte de réponse
 |
Remarque :Dans de nombreux cas, un navigateur Web ne constitue pas un client WMS préféré, mais il s'agit toujours d'un bon outil pour suivre et déboguer la communication entre un serveur et un client WMS.
Paramètres de demande WMS
Les spécifications de l'OGC pour un service de carte Web définissent une liste complète de paramètres de demande pouvant être utilisés dans chaque opération WMS. Reportez-vous aux liens ci-dessous pour consulter les différentes versions de la spécification de l'OGC pour l'implémentation WMS :
Les tableaux suivants listent tous les paramètres de demande applicables pour l'implémentation WMS dans ArcGIS Server, qui constituent uniquement un sous-ensemble des paramètres définis dans la spécification.
Paramètres d'une URL de demande WMS GetCapabilities
|
Obligatoire/facultatif |
Valeur par défaut |
Description | |
|---|---|---|---|
|
VERSION/WMTVER |
Facultatif |
1.3.0 (9.3 et versions ultérieures) 1.1.1 (9.2) |
Version de la demande. Utilisez WMTVER uniquement dans WMS 1.0.0 ; sinon, utilisez VERSION. |
|
SERVICE |
Obligatoire |
N/D |
Type de service. Il doit être défini sur WMS. Le paramètre n'est pas disponible dans WMS 1.0.0. |
|
REQUEST |
Obligatoire |
N/D |
Nom de la demande. Il doit être défini sur GetCapabilities. Pour WMS 1.0.0, il doit être défini sur capabilities. |
|
FORMAT |
Facultatif |
text/xml (9.3 et versions ultérieures) |
Format en sortie pour les métadonnées de service. Disponible uniquement dans WMS 1.3.0 (par exemple, application/vnd.ogc.wms_xml, text/plain ou text/html). |
Paramètres d'une URL de demande WMS GetMap
|
Obligatoire/facultatif |
Valeur par défaut |
Description | |
|---|---|---|---|
|
VERSION/WMTVER |
Obligatoire |
N/D |
Version de la demande. Utilisez WMTVER uniquement dans WMS 1.0.0 ; sinon, utilisez VERSION. |
|
REQUEST |
Obligatoire |
N/D |
Nom de la demande. Il doit être défini sur GetMap. Pour WMS 1.0.0, il doit être défini sur map. |
|
LAYERS |
Obligatoire |
N/D |
Liste séparée par des virgules d'une ou plusieurs couches (par exemple, 0,1,2 ou layer1, layer2). |
|
STYLES |
Obligatoire |
N/D |
Liste séparée par des virgules d'un ou plusieurs styles, un style par couche demandée (par exemple, 0,1,2 ou style1, style2). |
|
CRS/SRS |
Obligatoire |
N/D |
Système de référentiel de coordonnées. CRS est utilisé uniquement dans WMS 1.3.0, sinon utilisez SRS (par exemple, EPSG:4326 ou EPSG:4269). |
|
BBOX |
Obligatoire |
N/D |
Coins de l'emprise (inférieur gauche et supérieur droit) en unités CRS/SRS (par exemple, -180,-90,180,90). |
|
WIDTH |
Obligatoire |
N/D |
Largeur en pixels d'image de la carte (par exemple, 1024). |
|
HEIGHT |
Obligatoire |
N/D |
Hauteur en pixels d'image de la carte (par exemple, 768). |
|
FORMAT |
Obligatoire |
N/D |
Format en sortie de la carte (par exemple, image/png, image/jpeg ou image/svg+xml. |
|
TRANSPARENT |
Facultatif |
Faux |
Détermine si l'arrière-plan est transparent ou non (par exemple, True ou False). |
|
BGCOLOR |
Facultatif |
0xFFFFFF |
Couleur RVB hexadécimale pour l'arrière-plan de carte (par exemple, 0xFFFFFF ou FFFFFF). |
|
SLD |
Facultatif |
"" |
URL du fichier XML de descripteurs SLD. |
SLD_BODY | Facultatif | "" | Corps XML du fichier de descripteurs SLD. |
TIME | Facultatif | "" | Valeur de temps de la couche demandée. |
|
EXCEPTIONS |
Facultatif |
text/xml (WMS 1.3.0) application/vnd.ogc.se_xml (WMS 1.1.1 et WMS 1.1.0) application/vnd.ogc.inimage (WMS 1.0.0) |
Format dans lequel les exceptions doivent être signalées (par exemple, texte/xml ou texte/html). |
Paramètres d'une URL de demande WMS GetFeatureInfo
|
Obligatoire/facultatif |
Valeur par défaut |
Description | |
|---|---|---|---|
|
VERSION/WMTVER |
Obligatoire |
N/D |
Version de la demande. Utilisez WMTVER uniquement dans WMS 1.0.0 ; sinon, utilisez VERSION. |
|
REQUEST |
Obligatoire |
N/D |
Nom de la demande. Il doit être défini sur GetFeatureInfo. Pour WMS 1.0.0, il doit être défini sur feature_info. |
|
Partie de la demande de carte |
Obligatoire |
N/D |
Copie partielle des paramètres de demande GetMap ayant généré la carte pour laquelle les informations sont souhaitées. |
|
QUERY_LAYERS |
Obligatoire |
N/D |
Liste séparée par des virgules d'une ou plusieurs couches à interroger (par exemple, 0,1,2 ou layer1, layer2). |
|
INFO_FORMAT |
Obligatoire (WMS 1.3.0) Facultatif (WMS 1.1.1, 1.1.0, 1.0.0) |
N/D (WMS 1.3.0) text/xml (WMS 1.1.1, 1.1.0, 1.0.0) |
Format de retour des informations d'entité (par exemple, text/xml, text/html). |
|
I/X |
Obligatoire |
N/D |
Coordonnée X en pixels de l'entité dans le système de coordonnées cartographique (par exemple, 100). Utilisez I pour WMS 1.3.0 ; sinon, utilisez X. |
|
J/Y |
Obligatoire |
N/D |
Coordonnée Y en pixels de l'entité dans le système de coordonnées cartographique (par exemple, 100). Utilisez J pour WMS 1.3.0 ; sinon, utilisez Y. |
TIME | Facultatif | "" | Valeur de temps de la couche demandée. |
|
EXCEPTIONS |
Facultatif |
text/xml (WMS 1.3.0) application/vnd.ogc.se_xml (WMS 1.1.1 et WMS 1.1.0) application/vnd.ogc.inimage (WMS 1.0.0) |
Format dans lequel les exceptions doivent être signalées (par exemple, texte/xml ou texte/html). |
Paramètres d'une demande WMS GetStyles
|
Obligatoire/facultatif |
Valeur par défaut |
Description | |
|---|---|---|---|
|
VERSION |
Obligatoire |
1.3.0 (9.3 et versions ultérieures) 1.1.1 (9.2) |
Version telle que requise par les interfaces OGC. |
REQUEST |
Obligatoire |
N/D |
Nom de la demande. Il doit être défini sur GetStyles. |
LAYERS |
Obligatoire |
N/D |
Liste séparée par des virgules de couches nommées pour lesquelles récupérer des descriptions de style. |
SLDVER |
Facultatif |
1.0.0 (10.0) |
Version SLD demandée pour le document SLD. Seule la version 1.0.0 est prise en charge. |
Paramètres d'une demande WMS GetLegendGraphic
|
Obligatoire/facultatif |
Valeur par défaut |
Description | |
|---|---|---|---|
|
VERSION |
Obligatoire |
1.3.0 (9.3 et versions ultérieures) 1.1.1 (9.2) |
Version telle que requise par les interfaces OGC. |
REQUEST |
Obligatoire |
N/D |
Nom de la demande. Il doit être défini sur GetLegendGraphic. |
LAYER |
Obligatoire |
N/D |
Couche pour laquelle produire le graphique de légende. |
STYLE |
Facultatif |
default |
Style de la couche pour laquelle produire le graphique de légende. S'il est absent, le style par défaut est sélectionné. Le style peut correspondre à tout style valide disponible pour une couche, y compris les styles non SLD définis en interne. |
RULE | Facultatif | "" | Règle de style pour laquelle produire le graphique de légende, le cas échéant. Lorsqu'un style comporte plusieurs règles mais qu'aucune règle spécifique n'est sélectionnée, le service de carte est obligé de produire un graphique représentatif de toutes les règles du style. |
SLD | Facultatif | "" | Spécifie une référence à un document SLD. Ce paramètre fonctionne de manière semblable au paramètre SLD= de l'opération WMS GetMap. |
SLD_BODY | Facultatif | "" | Permet l'inclusion directe d'un document SLD dans une demande HTTP GET. Ce paramètre fonctionne de manière semblable au paramètre SLD_BODY de l'opération WMS GetMap. |
FORMAT | Facultatif | image/png (png24) | Type MIME du format de fichier dans lequel renvoyer le graphique de légende. Les valeurs autorisées sont les mêmes que pour le paramètre FORMAT= de la demande WMS GetMap. |
WIDTH | Facultatif | Dépend de l'image de légende spécifique | Donne une indication pour la largeur du graphique renvoyé en pixels. |
HEIGHT | Facultatif | Dépend de l'image de légende spécifique | Donne une indication pour la hauteur du graphique renvoyé en pixels. |
EXCEPTIONS | Facultatif | text/xml (WMS 1.3.0) application/vnd.ogc.se_xml (WMS 1.1.1 et WMS 1.1.0) application/vnd.ogc.inimage (WMS 1.0.0) | Type MIME du format dans lequel renvoyer les exceptions. Les valeurs autorisées sont les mêmes que pour le paramètre EXCEPTIONS= de la demande WMS GetMap. |