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
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
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. |