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.