GetMap: Parámetros

GetMap: Parámetros
Descripción extendida de los parámetros de la operación GetMap:
SERVICE: Indica cual de los tipos de servicios disponibles (WMS, WFS, WCS,
etc.) está siendo invocado. Es un parámetro obligatorio.
VERSION: Indica la versión del WMS. Es un parámetro obligatorio.
REQUEST: Se utiliza para invocar el tipo de operación, en este caso la
operación es GetMap. Es un parámetro obligatorio.
LAYERS: Se indica el nombre de la capa o de la lista de capas (separadas por
comas) que la solicitud GetMap debe devolver. Los nombres de capas
permitidos son los datos tipo carácter contenidos en el <Name> dentro de
<Layer> del XML de “Capabilities”. Un WMS debe interpretar las capas
solicitadas dibujando primero la capa más que primero se introduce en la lista,
es decir por debajo, y después la siguiente capa sobre esa y así
sucesivamente. Es un parámetro obligatorio.
STYLES: Indica el estilo en el que cada capa debe ser dibujada. Es un
parámetro obligatorio. El valor del parámetro STYLES es una lista separada por
comas de uno o más nombres de estilos válidos. Hay una correspondencia uno
a uno entre los valores en el parámetro LAYERS y los valores en el parámetro
STYLES. Cada capa del mapa en la lista de LAYERS se dibuja usando el
correspondiente estilo de la misma posición en la lista de STYLES. Cada
nombre de estilo deberá estar definido en un elemento <Name> de un
elemento <Style> que está directamente contenido dentro, o heredado por el
elemento <Layer> asociado en el XML de “capabilities”. En otras palabras, el
cliente no puede solicitar una capa en un estilo en el que estuviera definido
para otra capa diferente. El servidor deberá lanzar una excepción (code =
StyleNotDefined) si se solicita un estilo inesperado. Un cliente puede solicitar el
estilo por defecto usando un valor nulo (como en “STYLES =” ). Si varias capas
son solicitadas con una mezcla de estilos por defecto y estilos determinados, el
parámetro STYLES incluye valores nulos entre comas (como en “STYLES =
style1,,style2,,”). Si todas las capas son mostradas usando el estilo por defecto,
tanto de la forma “STYLES=” o “STYLES=,,,” es válida.SRS: Indica el Sistema
de Referencia de Coordenadas que se aplica a los valores del parámetro
BBOX. En la versión 1.3.0 este parámetro se denomina CRS. Es un parámetro
obligatorio. El valor del parámetro SRS deberá ser uno de los valores definidos
en elemento <SRS> definido o heredado por la capa solicitada. Si el servidor
WMS ha declarado SRS=NONE para una capa, entonces la capa no tiene un
sistema de referencias definido y no debería ser mostrada junto a otras capas
que si tengan definido el SRS.
BBOX: Permite al cliente solicitar un marco geográfico límite determinado. Es
un parámetro obligatorio. El valor del parámetro BBOX en una solicitud GetMap
es una lista de coordenadas separadas por comas de la forma
1
IGN & UPM-LatinGEO (Spain)
Esta obra está bajo una Licencia de Creative Commons.
GetMap: Parámetros
“minx,miny,maxx,maxy”. Si el servidor WMS ha declarado esa capa como no
divisible el cliente deberá especificar exactamente el valor del Bounding Box
declarado en la solicitud GetMap. FORMAT: Indica el formato solicitado para la
respuesta a una operación. Es un parámetro obligatorio. Los valores
soportados para una solicitud GetMap en una instancia WMS están listados en
uno o más elementos <Format> en el elemento <Request>de <GetMap> del
XML de “capabilities”. Toda la cadena de tipo MIME en <Format> se ejecuta
como valor del parámetro FORMAT. En un entorno HTTP, el tipo MIME debe
situarse en el objeto devuelto usando la entidad Content-type de la cabecera.
Para un servicio Web de mapas, los formatos permitidos son cualquier formato
de dibujo o de elementos gráficos, siendo los más comunes:
- Graphics Interchange Format (GIF; tipo MIME “image/gif”),
- Portable Network Graphics (PNG; tipo MIME “image/png”)
- Joint Photographics Expert Group (JPEG; tipo MIME “image/jpeg”),
Los formatos mencionados pueden ser mostrados en los navegadores más
conocidos, mientras que otros pueden requerir aplicaciones externas para
ayudar a mostrarlos.
Los formatos de elementos gráficos incluyen Scalable Vector Graphics (SVG)
y Web Computer Graphics Metafile (WebCGM).WIDTH, HEIGHT: Especifican
el tamaño en píxeles de la imagen de mapa que se creará. Son parámetros
obligatorios. Tanto WIDTH como HEIGHT son parámetros independientes.
WIDTH especifica el número de píxeles que se van a usar entre los valores
mínimo y máximo de las coordenadas X (ambos inclusive), mientras que
HEIGHT para las coordenadas Y, ambos del parámetro BBOX. La imagen
devuelta, sin tener en cuenta su formato de retorno, deberá tener exactamente
el ancho y alto especificado, en píxeles. En el caso donde el ratio del aspecto
de la BBOX y el ratio ancho/alto sean diferentes, el WMS deberá extender el
mapa devuelto de modo que los píxeles resultantes puedan ser dibujados con
el ratio de aspecto de la BBOX. En otras palabras, sería posible usar esta
definición para solicitar un mapa para un dispositivo cuyos píxeles de salida no
sean cuadrados, o extender un mapa dentro de un área de la imagen de un
ratio diferente. Si el servidor WMS ha declarado que una capa tiene un ancho y
alto fijo, el cliente deberá especificar exactamente los valores WIDTH y
HEIGHT en la solicitud GetMap. TRANSPARENT: Indica si el fondo del mapa
será transparente o no. Es un parámetro opcional. TRANSPARENT puede
tomar dos valores: TRUE o FALSE, siendo el valor por defecto FALSE si el
parámetro no aparece en la solicitud. La capacidad para devolver imágenes
dibujadas con píxeles transparentes permite que se superpongan resultados de
diferentes peticiones de mapas, produciendo mapas compuestos. Es altamente
recomendado que cada WMS ofrezca un formato que proporcione
transparencia para que las capas que puedan ser superpuestas sobre otras.
Considerando los formatos de imagen más comunes:
2
IGN & UPM-LatinGEO (Spain)
Esta obra está bajo una Licencia de Creative Commons.
GetMap: Parámetros
- el formato image/gif proporciona transparencia, en todos los navegadores.
- el formato image/png proporciona transparencia, pero no es soportado por
todos los navegadores.
- el formato image/jpeg no proporciona transparencia.
Cuando una capa ha sido declarada como opaca puede que porciones
significativas o el mapa entero no esté disponible para hacerse
transparente.BGCOLOR: Indica el color que se utiliza como fondo del mapa.
Es un parámetro opcional. El formato general de BGCOLOR es una
codificación hexadecimal de un valor RGB donde dos caracteres
hexadecimales son utilizados para cada uno de los colores rojo, verde y azul.
El valor puede estar en el rango de 00 y FF para cada uno (0 y 255, base 10).
El formato es 0xRRGGBB; pueden usarse tanto en mayúsculas como minúsculas
para los valores RR, GG, y BB. El prefijo “0x” debe tener la ‘x’ en minúscula. Si
este parámetro no aparece en la solicitud, el valor por defecto es 0xFFFFFF
(que corresponde con el color blanco). Cuando FORMAT es un formato de
imagen, un WMS deberá dibujar su salida en un fondo cuyos píxeles estaban
inicialmente y de manera uniforme del color codificado en BGCOLOR. Cuando
FORMAT es un formato de elemento gráfico (que no tiene un fondo explícito),
un WMS debería evitar usar el valor BGCOLOR para los elementos representados
porque no serían visibles frente a un fondo del mismo color. Cuando la capa ha
sido declarada como “opaca”, las porciones significativas o el mapa entero
puede que no se muestre con fondo alguno.EXCEPTIONS: Proporciona
información al cliente de los errores. Es un parámetro opcional.
application/vnd.ogc.se_xml (obligatorio): Los errores son informados usando
Service Exception XML. Este es el formato de excepción por defecto si no se
especifica ninguno en la solicitud. El tipo MIME del documento XML que
contiene el mensaje de error debe ser application/vnd.ogc.se_xml.
application/vnd.ogc.se_inimage (opcional): En el caso de formatos de imagen,
los mensajes de errores son devueltos gráficamente como parte del contenido.
Normalmente, esto significa que tomaría la forma de un texto con el mensaje
pintando dentro del mapa devuelto.
application/vnd.ogc.se_blank (opcional): En el caso de formatos de imágenes,
si el parámetro EXCEPTIONS es puesto a application/vnd.ogc.se_blank, el
WMS deberá, una vez que detecte un error, devolver el objeto del tipo
especificado en FORMAT cuyo contenido es uniformemente “off”. En el caso
de un formato imagen tal como GIF o JPEG, ese sería un objeto que contiene
sólo píxeles de un color (el color de fondo si se especifica BACKGROUND). En
el caso de un formato de imagen que soporte transparencia, si se especifica
TRANSPARENT = TRUE los píxeles deberán ser todos transparentes.
Otros: Existen otros parámetros como TIME, ELEVATION o dimensiones de
prueba.
3
IGN & UPM-LatinGEO (Spain)
Esta obra está bajo una Licencia de Creative Commons.