ArcGIS Server Java Help - 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

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

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

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

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

Nota:

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:

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.

3/6/2012