Comunicación con un servicio WMS en un navegador Web

Este tema muestra cómo puede utilizar los parámetros de dirección URL para comunicarse con un servicio WMS en un navegador Web.

Solicitud y respuesta de WMS

El recurso online de cada operación admitida por un servidor WMS compatible es un localizador de recursos uniforme (URL) de HTTP, de modo que un servicio WMS se puede considerar como un servicio de Transferencia de estado representacional (REST). A diferencia de un servicio Web estándar, no se requiere un cliente SOAP para utilizar un servicio WMS, y un navegador Web es el cliente más simple. Puede obtener metadatos al nivel de servicio del servicio WMS, una imagen de mapa o valores de atributos de una entidad al enviar una solicitud de dirección URL al servidor y visualizar las respuestas correspondientes en el navegador como un documento XML o una imagen.

A continuación se presentan algunas solicitudes y respuestas de muestra para cada operación admitida por un servicio WMS de ArcGIS Server.

Solicitud GetCapabilities de WMS

http://sampleserver1.arcgisonline.com/ArcGIS/services/Specialty/ESRI_StatesCitiesRivers_USA/MapServer/WMSServer?service=WMS&request=GetCapabilities&version=1.3.0

Respuesta XML

Respuesta XML GetCapabilities de WMS

Solicitud GetMap de WMS

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

Mapa de respuesta

Mapa de respuesta GetMap de WMS

Solicitud GetFeatureInfo de WMS

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

Respuesta XML

Respuesta XML GetFeature de WMS

Solicitud GetStyles de WMS

http://myserver/arcgis/services/OGC/SanFrancisco/MapServer/WMSServer?Service=WMS&Request=GetStyles&Version=1.3.0&Layers=pizzastores,highways,blockgroups

Respuesta XML

Respuesta XML GetStyles de WMS

Solicitud GetLegendGraphic de WMS

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

Respuesta al gráfico de leyenda

Gráfica de respuesta GetLegendGraphic de WMS

Solicitud GepMap de WMS con parámetro 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

Mapa de respuesta

Solicitud GepMap de WMS con mapa de respuesta del parámetro TIME
NotaNota:

En muchos casos, es posible que un navegador Web no sea un cliente WMS preferido, pero siempre es una buena herramienta para realizar el seguimiento y depurar la comunicación entre un servidor y un cliente WMS.

Parámetros de la solicitud WMS

Las especificaciones del servicio de mapas Web de OGC definen una lista completa de parámetros de solicitud que se pueden utilizar en cada operación WMS. Consulte los vínculos a continuación para obtener diferentes versiones de la especificación de la implementación OGC WMS:

Versión 1.3.0

Versión 1.1.1

Versión 1.1.0

Versión 1.0.0

Las tablas a continuación enumeran todos los parámetros de solicitud que se aplican a la implementación de WMS en ArcGIS Server, que solo es un subconjunto de aquellos que se definen en la especificación.

Parámetros de una dirección URL de solicitud GetCapabilities de WMS

Obligatorio/Opcional

Valor predeterminado

Descripción

VERSION/WMTVER

Opcional

1.3.0 (9.3 y superior)

1.1.1 (9.2)

Versión de solicitud. Use únicamente WMTVER en WMS 1.0.0; de lo contrario use VERSION.

SERVICIO

Obligatorio

N/D

Tipo de servicio. Se debe establecer a WMS. Este parámetro no está disponible en WMS 1.0.0.

REQUEST

Obligatorio

N/D

Nombre de solicitud. Se debe establecer a GetCapabilities. Para WMS 1.0.0, se debe establecer a capacidades.

FORMAT

Opcional

texto/xml (9.3 y superior)

Formato de salida para los metadatos del servicio. Este solo está disponible en WMS 1.3.0. (por ejemplo, application/vnd.ogc.wms_xml o texto/plano o texto/html).

Parámetros de una dirección URL de solicitud GetMap de WMS

Obligatorio/Opcional

Valor predeterminado

Descripción

VERSION/WMTVER

Obligatorio

N/D

Versión de solicitud. Use únicamente WMTVER en WMS 1.0.0; de lo contrario use VERSION.

REQUEST

Obligatorio

N/D

Nombre de solicitud. Se debe establecer a GetMap. Para WMS 1.0.0, se debe establecer a mapa.

LAYERS

Obligatorio

N/D

Una lista separada por comas de una o más capas de mapa (por ejemplo, 0,1,2 o capa1,capa2).

ESTILOS

Obligatorio

N/D

Una lista separada por comas de uno o más estilos, un estilo por capa solicitada (por ejemplo, 0,1,2 o estilo1,estilo2).

CRS/SRS

Obligatorio

N/D

Sistema de referencia de coordenadas. CRS solo se utiliza en WMS 1.3.0; de lo contrario, utilice SRS (por ejemplo, EPSG:4326 o EPSG:4269).

BBOX

Obligatorio

N/D

Esquinas del cuadro de delimitación (inferior izquierda y superior derecha) en unidades CRS/SRS (por ejemplo, -180,-90,180,90).

WIDTH

Obligatorio

N/D

El ancho en píxeles de imagen de mapa (por ejemplo, 1024).

HEIGHT

Obligatorio

N/D

La altura en píxeles de imagen de mapa (por ejemplo, 768).

FORMAT

Obligatorio

N/D

Formato de salida del mapa (por ejemplo imagen/png o imagen/jpeg o imagen/svg+xml.

TRANSPARENTE

Opcional

Falso

Determina si el fondo es o no transparente (por ejemplo, Verdadero o Falso).

BGCOLOR

Opcional

0xFFFFFF

El color RVA hexadecimal para el fondo del mapa (por ejemplo, 0xFFFFFF o FFFFFF).

SLD

Opcional

""

Dirección URL del archivo XML del Descriptor de capa con estilo.

SLD_BODY

Opcional

""

Cuerpo de XML del archivo del Descriptor de capa con estilo.

TIME

Opcional

""

Valor de tiempo de la capa solicitada.

EXCEPTIONS

Opcional

text/xml (WMS 1.3.0)

application/vnd.ogc.se_xml (WMS 1.1.1 y WMS 1.1.0)

application/vnd.ogc.inimage (WMS 1.0.0)

El formato en el que se deben informar las excepciones (por ejemplo, texto/xml o texto/html).

Parámetros de una dirección URL de solicitud GetFeatureInfo de WMS

Obligatorio/Opcional

Valor predeterminado

Descripción

VERSION/WMTVER

Obligatorio

N/D

Versión de solicitud. Use únicamente WMTVER en WMS 1.0.0; de lo contrario use VERSION.

REQUEST

Obligatorio

N/D

Nombre de solicitud. Se debe establecer a GetFeatureInfo. Para WMS 1.0.0, se debe establecer a feature_info.

Parte de la solicitud del mapa

Obligatorio

N/D

Copia parcial de los parámetros de la solicitud GetMap que generó el mapa para el que se desea la información.

QUERY_LAYERS

Obligatorio

N/D

Una lista separada por comas de una o más capas de mapa a consultar (por ejemplo, 0,1,2 o capa1,capa2).

INFO_FORMAT

Obligatorio (WMS 1.3.0)

Opcional (WMS 1.1.1, 1.1.0, 1.0.0)

N/D (WMS 1.3.0)

texto/xml (WMS 1.1.1, 1.1.0, 1.0.0)

Formato devuelto de la información de entidades (por ejemplo, texto/xml, texto/html).

I/X

Obligatorio

N/D

Coordenada X en píxeles de entidades en el sistema de coordenadas del mapa (por ejemplo, 100). Utilice I para WMS 1.3.0; de lo contrario, utilice X.

J/Y

Obligatorio

N/D

Coordenada Y en píxeles de entidades en el sistema de coordenadas del mapa (por ejemplo, 100). Utilice J para WMS 1.3.0; de lo contrario, utilice Y.

TIME

Opcional

""

Valor de tiempo de la capa solicitada.

EXCEPTIONS

Opcional

text/xml (WMS 1.3.0)

application/vnd.ogc.se_xml (WMS 1.1.1 y WMS 1.1.0)

application/vnd.ogc.inimage (WMS 1.0.0)

El formato en el que se deben informar las excepciones (por ejemplo, texto/xml o texto/html).

Parámetros de una solicitud GetStyles de WMS

Obligatorio/Opcional

Valor predeterminado

Descripción

VERSION

Obligatorio

1.3.0 (9.3 y superior)

1.1.1 (9.2)

Versión según requieran las interfaces OGC.

REQUEST

Obligatorio

N/D

Nombre de solicitud. Se debe establecer a GetStyles.

LAYERS

Obligatorio

N/D

Una lista separada por comas de capas con nombre para las que se deben recuperar las descripciones de estilo.

SLDVER

Opcional

1.0.0 (10.0)

La versión SLD solicitada para el documento SLD. Solo se admite la versión 1.0.0.

Parámetros de una solicitud GetLegendGraphic de WMS

Obligatorio/Opcional

Valor predeterminado

Descripción

VERSION

Obligatorio

1.3.0 (9.3 y superior)

1.1.1 (9.2)

Versión según requieran las interfaces OGC.

REQUEST

Obligatorio

N/D

Nombre de solicitud. Se debe establecer a GetLegendGraphic.

CAPA

Obligatorio

N/D

Capa para la que se debe generar el gráfico de leyenda.

ESTILO

Opcional

predeterminada

Estilo de capa para el que se debe generar el gráfico de leyenda. Si no se encuentra, se selecciona el estilo predeterminado. El estilo puede ser cualquier estilo válido disponible para una capa, incluidos los estilos que no están definidos internamente por SLD.

REGLA

Opcional

""

Regla de estilo para la que se debe generar el gráfico de leyenda, si corresponde. Cuando un estilo tiene varias reglas pero no se selecciona ninguna regla específica, el servicio de mapas está obligado a generar un gráfico que sea representativo de todas las reglas del estilo.

SLD

Opcional

""

Especifica una referencia a un documento SLD. Funciona del mismo modo que el parámetro SLD= de la operación GetMap de WMS.

SLD_BODY

Opcional

""

Permite incluir un documento SLD directamente en una solicitud GET de HTTP. Funciona del mismo modo que el parámetro SLD_BODY de la operación GetMap de WMS.

FORMAT

Opcional

imagen/png (png24)

El tipo MIME del formato de archivo en el que se debe devolver el gráfico de leyenda. Los valores permitidos son los mismos que para el parámetro FORMATO= de la solicitud GetMap de WMS.

WIDTH

Opcional

Depende de la imagen de la leyenda específica

Brinda una sugerencia para el ancho de los gráficos devueltos en píxeles.

HEIGHT

Opcional

Depende de la imagen de la leyenda específica

Brinda una sugerencia para la altura de los gráficos devueltos en píxeles.

EXCEPTIONS

Opcional

text/xml (WMS 1.3.0)

application/vnd.ogc.se_xml (WMS 1.1.1 y WMS 1.1.0)

application/vnd.ogc.inimage (WMS 1.0.0)

El tipo MIME del formato en el que se deben devolver las excepciones. Los valores permitidos son los mismos que para el parámetro EXCEPCIONES= de la solicitud GetMap de WMS.


7/11/2012