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

Réponse XML WMS GetCapabilities

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

Carte de réponse WMS GetMap

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

Réponse XML WMS GetFeatureInfo

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

Réponse XML WMS GetStyles

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

Graphique de réponse WMS GetLegendGraphic

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

Carte de réponse de demande WMS GetMap avec paramètre TIME
RemarqueRemarque :

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 :

Version 1.3.0

Version 1.1.1

Version 1.1.0

Version 1.0.0

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.


3/6/2012