Importante

La traducción es un esfuerzo comunitario al que puedes unirte. Esta página está actualmente traducida en 100.00%.

3.2. Web Map Service (WMS)

Los estándares WMS 1.1.1 y 1.3.0 implementados en QGIS Server proporcionan una interfaz HTTP para solicitar imágenes de mapas o leyendas generadas a partir de un proyecto QGIS. Una solicitud WMS típica define el proyecto QGIS que se utilizará, las capas que se renderizarán y el formato de imagen que se generará. El soporte básico también está disponible como Descriptor de capa con estilo (SLD).

Especificaciones:

Solicitudes standard proporcionadas por el servidor QGIS:

Solicitud

Descripción

GetCapabilities

Devuelve metadatos XML con información sobre el servidor

GetMap

Devuelve un mapa

GetFeatureInfo

Recupera datos (geometría y valores) para una ubicación de píxeles

GetLegendGraphic

Devuelve símbolos de leyenda

GetStyle(s)

Devuelve un documento XML con descripción de estilo en SLD

DescribeLayer

Devuelve información sobre la disponibilidad de WFS y WCS respectivamente para capas vectoriales y ráster

Solicitudes de proveedor proporcionadas por QGIS Server:

Solicitud

Descripción

GetPrint

Devuelve un diseño QGIS

GetProjectSettings

Devuelve información específica sobre QGIS Server

GetSchemaExtension

Devuelve metadatos XML sobre capacidades extendidas opcionales

3.2.1. GetCapabilities

Parámetros estándar para la solicitud GetCapabilities según las especificaciones OGC WMS 1.1.1 y 1.3.0:

Parámetros

Necesario

Descripción

SERVICE

Nombre del servicio (WMS)

REQUEST

Nombre de la solicitud (Obtener Capacidades)

VERSION

No

Versión del servicio

La solicitud GetCapabilities también admite los siguientes parámetros de proveedor:

Parámetros

Necesario

Descripción

MAP

Archivo de proyecto QGIS

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetCapabilities

3.2.2. GetMap

Parámetros estándar para la petición GetMap de acuerdo con las especificaciones OGC WMS 1.1.1 y 1.3.0:

Parámetros

Necesario

Descripción

SERVICE

Nombre del servicio (WMS)

REQUEST

Nombre de la petición (GetMap)

VERSION

Versión del servicio

LAYERS

No

Capas a mostrar

STYLES

No

Estilo de capas

SRS / CRS

Sistema de referencia de coordenadas

BBOX

Extensión del mapa

WIDTH

Ancho de la imagen en píxeles.

HEIGHT

Altura de la imagen en píxeles

FORMAT

No

Formato de imagen

TRANSPARENT

No

fondo transparente

SLD

No

URL de una SLD que se utilizará para diseñar

SLD_BODY

No

SLD en línea (XML) que se utilizará para diseñar

Además de los estándar, QGIS Server admite redlining así como los siguientes parámetros adicionales:

Parámetros

Necesario

Descripción

MAP

Archivo de proyecto QGIS

BGCOLOR

No

Especifica el color de fondo

DPI

No

Especifica la resolución de salida

IMAGE_QUALITY

No

compresión JPEG

OPACITIES

No

Opacidad de la capa o Grupo

FILTER

No

Subconjunto de entidades

SELECTION

No

Resalta entidades

FILE_NAME

No

Nombre de archivo de la capa descargada

Solo para``FORMAT=application/dxf``

FORMAT_OPTIONS

No

Opciones del formato de archivo especificado

Solo para``FORMAT=application/dxf``

TILED

No

Trabajando en modo teselado

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetMap
&MAP=/home/qgis/projects/world.qgs
&LAYERS=mylayer1,mylayer2,mylayer3
&STYLES=style1,default,style3
&OPACITIES=125,200,125
&CRS=EPSG:4326
&WIDTH=400
&HEIGHT=400
&FORMAT=image/png
&TRANSPARENT=TRUE
&DPI=300
&TILED=TRUE

VERSION

Este parámetro permite especificar la versión del servicio a utilizar. Los valores disponibles para el parámetro VERSIÓN son:

  • 1.1.1

  • 1.3.0

Según el número de versión, se esperan ligeras diferencias como se explica más adelante para los siguientes parámetros:

  • CRS / SRS

  • BBOX

LAYERS

Este parámetro permite especificar las capas que se mostrarán en el mapa. Los nombres deben estar separados por una coma.

Además, QGIS Server introdujo algunas opciones para seleccionar capas mediante:

  • el id de capa: la opción del proyecto que permite seleccionar capas por su id se encuentra en la pestaña QGIS Servidor ► WMS del diálogo Proyecto ► Propiedades…. Marque la casilla Usar ids de capa como nombres para activar esta opción.

  • un short name

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&LAYERS=mylayerid1,mylayerid2
&...

STYLES

Este parámetro se puede utilizar para especificar el estilo de una capa para el paso de renderizado. Los estilos deben estar separados por una coma. El nombre del estilo predeterminado es default.

SRS / CRS

Este parámetro permite indicar la salida del mapa Spatial Reference System en WMS 1.1.1 y tiene que ser foramdo como EPSG:XXXX. Note que SRC también es compatible si la versión actual es 1.1.1.

Para WMS 1.3.0, es preferible el parámetro SRC pero también se admite SRS.

Tenga en cuenta que si en la solicitud se indican los parámetros SRC y SRS, entonces es la versión actual indicada en el parámetro VERSIÓN la que es decisiva.

En el siguiente caso, el parámetro SRS se mantiene cualquiera que sea el parámetro VERSION porque no se indica SRC:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&SRS=EPSG:2854
&...

En el siguiente caso, el parámetro SRS se mantiene en lugar de SRC debido al parámetro VERSIÓN:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.1.1
&CRS=EPSG:4326
&SRS=EPSG:2854
&...

En el siguiente caso, el parámetro SRC se mantiene en lugar de SRS debido al parámetro VERSION:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&CRS=EPSG:4326
&SRS=EPSG:2854
&...

BBOX

Este parámetro permite especificar la extensión del mapa con unidades según el SRC actual. Las coordenadas deben estar separadas por una coma.

El parámetro BBOX se forma como min_a,min_b,max_a,max_b pero la definición de los ejes a y b es diferente según el parámetro VERSION actual:

  • en WMS 1.1.1, el orden de los ejes siempre es este/norte

  • en WMS 1.3.0, el orden de los ejes depende de la autoridad CRS

Por ejemplo, en el caso de EPSG:4326 y WMS 1.1.1, a es la longitud (este) y b la latitud (norte), lo que lleva a una solicitud como :

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.1.1
&SRS=epsg:4326
&BBOX=-180,-90,180,90
&...

Pero en el caso de WMS 1.3.0, el orden de los ejes definido en la base de datos EPSG es norte/este, por lo que a es la latitud y b la longitud:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&CRS=epsg:4326
&BBOX=-90,-180,90,180
&...

WIDTH

Este parámetro permite especificar el ancho en píxeles de la imagen de salida.

HEIGHT

Este parámetro permite especificar la altura en píxeles de la imagen de salida.

FORMAT

Este parámetro se puede utilizar para especificar el formato de la imagen del mapa. Los valores disponibles son:

  • jpg

  • jpeg

  • image/jpeg

  • image/png

  • image/png; mode=1bit

  • image/png; mode=8bit

  • image/png; mode=16bit

  • image/webp

  • application/dxf: solo las capas que tienen acceso de lectura en el servicio WFS se exportan en formato DXF

    URL ejemplo:

    http://localhost/qgisserver?
    SERVICE=WMS&VERSION=1.3.0
    &REQUEST=GetMap
    &FORMAT=application/dxf
    &LAYERS=Haltungen,Normschacht,Spezialbauwerke
    &CRS=EPSG%3A21781
    &BBOX=696136.28844801,245797.12108743,696318.91114315,245939.25832905
    &WIDTH=1042
    &HEIGHT=811
    &FORMAT_OPTIONS=MODE:SYMBOLLAYERSYMBOLOGY;SCALE:250
    &FILE_NAME=plan.dxf
    

TRANSPARENT

Este parámetro booleano se puede utilizar para especificar la transparencia del fondo. Los valores disponibles son (no distinguen entre mayúsculas y minúsculas):

  • TRUE

  • FALSE

Sin embargo, este parámetro se ignora si el formato de la imagen indicada con FORMAT es diferente de PNG.

BGCOLOR

Este parámetro permite indicar un color de fondo para la imagen del mapa. Sin embargo, no se puede combinar con el parámetro `` TRANSPARENTE`` en el caso de imágenes PNG (la transparencia tiene prioridad). El color puede ser literal o en notación hexadecimal.

URL ejemplo con la notación literal:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&BGCOLOR=green
&...

Ejemplo URL con la notación hexadecimal:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&BGCOLOR=0x00FF00
&...

DPI

Este parámetro se puede utilizar para especificar la resolución de salida solicitada.

IMAGE_QUALITY

Este parámetro solo se utiliza para imágenes JPEG. De forma predeterminada, la compresión JPEG es -1.

Puede cambiar el valor predeterminado por proyecto QGIS en el menú OWS Server -> Capacidades WMS del Proyecto -> Propiedades…. Si desea anularlo en una solicitud GetMap puede hacerlo usando el parámetro ʻIMAGE_QUALITY`.

OPACITIES

Lista de valores de opacidad separados por comas. La opacidad se puede establecer a nivel de capa o grupo. Los valores permitidos van desde 0 (totalmente transparente) a 255 (totalmente opaco).

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&WIDTH=400
&HEIGHT=200
&CRS=EPSG:4326
&LAYERS=countries,places
&BBOX=42,-6,52,15
&OPACITIES=255,0
../../../_images/wms_getmap_opacities.png

Figura 3.2 A la izquierda OPACITIES=255,0 y a la derecha OPACITIES=255,255

FILTER

Se puede seleccionar un subconjunto de capas con el parámetro FILTRO La sintaxis es básicamente la misma que para la cadena del subconjunto QGIS. Sin embargo, existen algunas restricciones para evitar inyecciones de SQL en bases de datos a través de QGIS Server. Si se encuentra una cadena peligrosa en el parámetro, QGIS Server devolverá el siguiente error:

<ServiceExceptionReport>
  <ServiceException code="Security">The filter string XXXXXXXXX has been rejected because of security reasons.
  Note: Text strings have to be enclosed in single or double quotes. A space between each word / special character is mandatory.
  Allowed Keywords and special characters are IS,NOT,NULL,AND,OR,IN,=,<,=<,>,>=,!=,',',(,),DMETAPHONE,SOUNDEX.
  Not allowed are semicolons in the filter expression.</ServiceException>
</ServiceExceptionReport>

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&VERSION=1.3.0
&WIDTH=400
&HEIGHT=300
&CRS=EPSG:4326
&BBOX=41,-6,52,10
&LAYERS=countries_shapeburst,countries,places
&FILTER=countries_shapeburst,countries:"name" = 'France';places: "name" = 'Paris'
../../../_images/wms_getmap_filter.png

Figura 3.3 Respuesta del servidor a una solicitud GetMap con parámetro FILTER

En este ejemplo, el mismo filtro "name" = 'France' se aplica a las capas countries y countries_shapeburst, mientras que el filtro "name" = 'Paris' es solo aplicado a places.

Nota

Es posible realizar búsquedas de atributos a través de GetFeatureInfo y omitir el parámetro X / Y si hay un FILTRO. QGIS Server luego devuelve información sobre las características coincidentes y genera un cuadro delimitador combinado en la salida XML.

SELECTION

El parámetro SELECCIÓN puede resaltar entidades de una o más capas. Las características vectoriales se pueden seleccionar pasando listas separadas por comas con identificadores de objetos.

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&LAYERS=mylayer1,mylayer2
&SELECTION=mylayer1:3,6,9;mylayer2:1,5,6
&...

La siguiente imagen presenta la respuesta de una solicitud GetMap usando la opción SELECTION p.ej. http://myserver.com/...&SELECTION=countries:171,65.

Como los identificadores de esas características corresponden en el conjunto de datos de origen a Francia y Rumanía, están resaltados en amarillo.

../../../_images/server_selection_parameter.png

Figura 3.4 Respuesta del servidor a una solicitud GetMap con el parámetro SELECTION

FORMAT_OPTIONS

Este parámetro puede utilizarse para especificar opciones para el formato seleccionado. Sólo para FORMAT=application/dxf en la petición GetMap. Toma una lista de pares clave:valor separados por punto y coma:

  • ESCALA: para ser utilizado para reglas de simbología, filtros y estilos (no escala real de los datos - los datos permanecen en la escala original).

  • MODO: corresponde a las opciones de exportación que se ofrecen en el cuadro de diálogo de exportación QGIS Desktop DXF. Los valores posibles son NOSYMBOLOGY, FEATURESYMBOLOGY y SYMBOLLAYERSYMBOLOGY.

  • LAYERATTRIBUTES: especifique un campo o, en caso de muchas capas, una lista de campos separados por comas que contenga valores para los nombres de capa DXF - si no se especifica, se utilizan los nombres de capa originales de QGIS.

  • USE_TITLE_AS_LAYERNAME: si está habilitado, el título de la capa se utilizará como nombre de capa.

  • CODEC: especificar un códec que se utilizará para la codificación. El valor predeterminado es ISO-8859-1. Consulte el cuadro de diálogo de exportación DXF del escritorio de QGIS para obtener valores válidos.

  • NO_MTEXT: Utilice TEXT en lugar de MTEXT para las etiquetas.

  • FORCE_2D: Forzar salida 2D. Esto es necesario para el ancho de la polilínea.

TILED

Por motivos de rendimiento, QGIS Server se puede utilizar en modo mosaico. En este modo, el cliente solicita varios mosaicos pequeños de tamaño fijo y los ensambla para formar el mapa completo. Al hacer esto, los símbolos en o cerca del límite entre dos teselas pueden aparecer cortados, porque solo están presentes en una de los teselas.

Establezca el parámetro TILED en TRUE para decirle al servidor QGIS que funcione en modo teselado y para aplicar el búfer de teselas configurado en el proyecto QGIS (consulte Configure su proyecto).

Cuando TILED es TRUE y cuando se configura un búfer de mosaico distinto de cero en el proyecto QGIS, las entidades fuera de la extensión del mosaico se dibujan para evitar símbolos de corte en los límites del mosaico.

TILED predeterminado como FALSE.

3.2.3. GetFeatureInfo

Parámetros estándar para la petición GetFeatureInfo de acuerdo con las especificaciones OGC WMS 1.1.1 y 1.3.0 :

Parámetros

Necesario

Descripción

SERVICE

Nombre del servicio (WMS)

REQUEST

Nombre de la solicitud (GetFeatureInfo)

VERSION

No

Versión del servicio

QUERY_LAYERS

Capas a consultar

LAYERS

Capas para mostrar (idénticas a QUERY_LAYERS)

STYLES

No

Estilo de capas

SRS / CRS

Sistema de referencia de coordenadas

BBOX

No

Extensión del mapa

WIDTH

Ancho de la imagen en píxeles.

HEIGHT

Altura de la imagen en píxeles

TRANSPARENT

No

fondo transparente

INFO_FORMAT

No

Formato de salida

FEATURE_COUNT

No

Número máximo de objetos espaciales a devolver

I

No

Columna de píxeles del punto a consultar

X

No

Igual que el parámetro I, pero en WMS 1.1.1

J

No

Fila de píxeles del punto a consultar

Y

No

Igual que el parámetro J, pero en WMS 1.1.1

WMS_PRECISION

No

La precisión (número de dígitos) que se utilizará al devolver la geometría (consulte Cómo agregar geometría a la respuesta de la función). El valor predeterminado es -1, lo que significa que se utiliza la precisión definida en el proyecto.

En adición a los estándares, QGIS Server apoya los siguientes parámetros extra:

Parámetros

Necesario

Descripción

MAP

Archivo de proyecto QGIS

FILTER

No

Subconjunto de entidades

FI_POINT_TOLERANCE

No

Tolerancia en pixeles para capas punto

FI_LINE_TOLERANCE

No

Tolerancia en pixeles para capas línea

FI_POLYGON_TOLERANCE

No

Tolerancia en píxeles para capas polígono

FILTER_GEOM

No

Filtrado de geometría

WITH_DISPLAY_NAME

No

Añadir el nombre del objeto espacial a la salida

WITH_MAPTIP

No

Agregar consejos de mapa a la salida

WITH_GEOMETRY

No

Agregar geometría a la salida

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetMap
&MAP=/home/qgis/projects/world.qgs
&LAYERS=mylayer1,mylayer2,mylayer3
&CRS=EPSG:4326
&WIDTH=400
&HEIGHT=400
&INFO_FORMAT=text/xml
&TRANSPARENT=TRUE
&QUERY_LAYERS=mylayer1
&FEATURE_COUNT=3
&I=250
&J=250

INFO_FORMAT

Este parámetro se puede utilizar para especificar el formato del resultado. Los valores disponibles son:

  • text/xml

  • text/html

  • text/plain

  • application/vnd.ogc.gml

  • application/json

QUERY_LAYERS

Este parámetro especifica las capas a mostrar en el mapa. Nombres son separados por comas.

Además, El servidor de QGIS presenta opciones para seleccionar las capas por:

  • nombre corto

  • id capa

Consulte el parámetro LAYERS definido en GetMap para obtener más información.

FEATURE_COUNT

Este parámetro especifica el número máximo de características por capa a devolver. Por ejemplo, si QUERY_LAYERS se establece en layer1,layer2 y FEATURE_COUNT se establece en 3, se devolverá un máximo de 3 características de la capa1. Del mismo modo, se devolverá un máximo de 3 características de la capa 2.

De formar predeterminada, sólo 1 objeto espacial por capa es devuelto.

I

Este parámetro, definido en WMS 1.3.0, le permite especificar la columna de pixeles del punto de consulta.

X

Igual que el parámetro I, pero definido en WMS 1.1.1.

J

Este parámetro, definido en WMS 1.3.0, le permite especificar la fila de pixeles del punto de consulta.

Y

Igual que el parámetro J, pero definido en WMS 1.1.1.

FI_POINT_TOLERANCE

Este parámetro especifica la tolerancia en pixeles para capas de puntos.

FI_LINE_TOLERANCE

Este parámetro especifica la tolerancia en pixeles para capas de líneas.

FI_POLYGON_TOLERANCE

Este parámetro especifica la tolerancia en pixeles para capas de polígonos.

FILTER_GEOM

Este parámetro especifica una gepmetría WKT con la cuál las entidades deben intersecarse.

WITH_DISPLAY_NAME

Este parámetro especifica si se añade el nombre del objeto espacial a la salida.

Valores disponibles son (no en caso sensitivo):

  • TRUE

  • FALSE

WITH_MAPTIP

Este parámetro especifica si agregar sugerencias de mapas a la salida.

Valores disponibles son (no en caso sensitivo):

  • TRUE

  • FALSE

WITH_GEOMETRY

Este parámetro especifica si se deben agregar geometrías a la salida. Para usar esta función, primero debe habilitar la opción: guilabel:Añadir geometría a la entidad de respuesta en el proyecto QGIS. Ver: ref: Configura tu proyecto <Creatingwmsfromproject>.

Valores disponibles son (no en caso sensitivo):

  • TRUE

  • FALSE

3.2.4. GetLegendGraphic

Parámetros estándar para el GetLegendGraphic pedido de acuerdo a las especificaciones OGC WMS 1.1.1 y 1.3.0 :

Parámetros

Necesario

Descripción

SERVICE

Nombre del servicio (WMS)

REQUEST

Nombre del pedido (GetLegendGraphic)

VERSION

No

Versión del servicio

LAYERS

Capas a mostrar

STYLES

No

Estilo de capas

SRS / CRS

No

Sistema de referencia de coordenadas

BBOX

No

Extensión del mapa

WIDTH

No

Ancho de la imagen en píxeles.

HEIGHT

No

Altura de la imagen en píxeles

FORMAT

No

Legend format

TRANSPARENT

No

fondo transparente

Además de los estándar, QGIS Server admite parámetros adicionales para cambiar el tamaño de los elementos de la leyenda o las propiedades de la fuente para los títulos de las capas y las etiquetas de los elementos:

Parámetros

Necesario

Descripción

MAP

Archivo de proyecto QGIS

SRCWIDTH

No

Ancho del mapa

SRCHEIGHT

No

Altura de mapa

SHOWFEATURECOUNT

No

Agregar cuenta de características de características

RULE

No

Símbolo de regla para representar

RULELABEL

No

Representación de etiquetas de elementos

BOXSPACE

No

Espacio entre marco de leyenda y contenido (mm)

LAYERSPACE

No

Espacio entre marcos de leyenda y contenido (mm)

LAYERTITLESPACE

No

Espacio vertical entre el título de la capa y los elementos (mm)

SYMBOLSPACE

No

Espacio vertical entre símbolo y elementos (mm)

ICONLABELSPACE

No

Espacio horizontal entre símbolo y etiqueta (mm)

SYMBOLWIDTH

No

Ancho de la vista previa del símbolo (mm)

SYMBOLHEIGHT

No

Altura de la vista previa del símbolo (mm)

LAYERTITLE

No

Representación del título de la capa

LAYERFONTFAMILY

No

Familia de fuentes de capas

LAYERFONTBOLD

No

Representación en negrita del título de la capa

LAYERFONTSIZE

No

Tamaño de fuente del título de la capa (pt)

LAYERFONTITALIC

No

Representación en cursiva del título de la capa

LAYERFONTCOLOR

No

Color del título de la capa

ITEMFONTFAMILY

No

Familia de fuentes de elementos

ITEMFONTBOLD

No

Representación en negrita de la etiqueta del artículo

ITEMFONTSIZE

No

Tamaño de fuente de la etiqueta del elemento (pt)

ITEMFONTITALIC

No

Representación en cursiva de la etiqueta del elemento

ITEMFONTCOLOR

No

Color de la etiqueta del artículo

ADDLAYERGROUPS

No

Añade los grupos de capas a la salida JSON

BBOX

Este parámetro se puede usar para especificar el área geográfica para la cual se debe construir la leyenda (su formato se describe here) pero no se puede combinar con el parámetro RULE. El parámetro SRS/CRS se vuelve obligatorio cuando se usa el parámetro BBOX.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries,airports
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326

Nota

Cuando se define el parámetro BBOX, la leyenda se denomina content based legend.

WIDTH

Este parámetro no se usa de forma predeterminada, pero se vuelve obligatorio cuando se establece el parámetro RULE. En este caso permite especificar el ancho en píxeles de la imagen de salida.

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=getlegendgraphic
&LAYER=testlayer%20%C3%A8%C3%A9
&RULE=rule1
&WIDTH=30
&HEIGHT=30

HEIGHT

Este parámetro no se usa de forma predeterminada, pero se vuelve obligatorio cuando se establece el parámetro RULE. En este caso permite especificar la altura en píxeles de la imagen de salida.

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYER=testlayer%20%C3%A8%C3%A9
&RULE=rule1
&WIDTH=30
&HEIGHT=30

FORMAT

Este parámetro se puede utilizar para especificar el formato de la imagen de la leyenda. Los valores disponibles son:

  • image/jpeg

  • image/png

  • application/json

Para JSON, los símbolos se codifican con Base64 y la mayoría de las demás opciones relacionadas con el diseño o las fuentes no se tienen en cuenta porque la leyenda debe construirse en el lado del cliente. El parámetro RULE no se puede combinar con este formato.

Ejemplo de URL con la salida JSON correspondiente:

http://localhost/qgisserver?
SERVICE=WMS&
REQUEST=GetLegendGraphic&
LAYERS=airports&
FORMAT=application/json

Y la salida JSON correspondiente:

{
  "nodes":[
    {
      "icon":"<base64 icon>",
      "title":"airports",
      "type":"layer"
    }
  ],
  "title":""
}

SRCWIDTH

Este parámetro puede definirse cuando se establece el parámetro RULE. En este caso, el valor SRCWIDTH se envía a la solicitud GetMap subyacente como parámetro WIDTH, mientras que el parámetro WIDTH de GetLegendGraphic se utiliza para el tamaño de la leyenda de la imagen.

SRCHEIGHT

Este parámetro puede definirse cuando se establece el parámetro RULE. En este caso, el valor SRCHEIGHT se envía a la solicitud GetMap subyacente como parámetro HEIGHT, mientras que el parámetro HEIGHT de GetLegendGraphic se utiliza para el tamaño de la leyenda de la imagen.

SHOWFEATURECOUNT

Este parámetro se puede utilizar para activar el recuento de características en la leyenda. Los valores disponibles son (no distingue entre mayúsculas y minúsculas):

  • TRUE

  • FALSE

Por ejemplo:

../../../_images/getfeaturecount_legend.png

RULE

Este parámetro está disponible en capas con Renderizado basado en reglas y permite construir una leyenda sólo con el símbolo de la regla nombrada. No puede combinarse con el parámetro BBOX ni con el formato JSON. Es necesario especificar HEIGHT y WIDTH.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=mylayer,
&RULE=myrulename,
&WIDTH=20,
&HEIGHT=20

RULELABEL

Este parámetro permite controlar la representación de la etiqueta del artículo. Los valores disponibles son (no distingue entre mayúsculas y minúsculas):

  • TRUE: etiqueta del elemento de visualización

  • FALSE: ocultar la etiqueta del artículo

  • AUTO: ocultar la etiqueta del elemento para las capas con representación Single symbol

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries,airports
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&RULELABEL=AUTO
../../../_images/wms_getlegendgraphic_rulelabel.png

Figura 3.5 Representación de leyenda sin etiqueta para capas de un solo símbolo

BOXSPACE

Este parámetro permite especificar el espacio entre el marco de la leyenda y el contenido en milímetros. Por defecto, el valor del espacio es 2 mm.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&BOXSPACE=0
../../../_images/wms_getlegendgraphic_boxspace.png

Figura 3.6 A la izquierda BOXSPACE=0 y a la derecha BOXSPACE=15

LAYERSPACE

Este parámetro permite especificar el espacio vertical entre capas en milímetros. Por defecto, el valor del espacio es 3 mm.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&LAYERSPACE=0
../../../_images/wms_getlegendgraphic_layerspace.png

Figura 3.7 A la izquierda LAYERSPACE=0 y a la derecha LAYERSPACE=10

LAYERTITLESPACE

Este parámetro permite especificar el espacio vertical entre el título de la capa y los siguientes elementos en milímetros. Por defecto el valor del espacio es 3 mm.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&LAYERTITLESPACE=0
../../../_images/wms_getlegendgraphic_layertitlespace.png

Figura 3.8 A la izquierda LAYERTITLESPACE=0 y a la derecha LAYERTITLESPACE=10

SYMBOLSPACE

Este parámetro permite especificar el espacio vertical entre el símbolo y el elemento siguiente en milímetros. Por defecto el valor del espacio es 2 mm.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&SYMBOLSPACE=0
../../../_images/wms_getlegendgraphic_symbolspace.png

Figura 3.9 A la izquierda SYMBOLSPACE=0 y a la derecha SYMBOLSPACE=5

ICONLABELSPACE

Este parámetro permite especificar el espacio horizontal entre el símbolo y el texto de la etiqueta en milímetros. Por defecto el valor del espacio es 2 mm.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=getlegendgraphic
&LAYERS=countries,
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&ICONLABELSPACE=0
../../../_images/wms_getlegendgraphic_iconlabelspace.png

Figura 3.10 A la izquierda ICONLABELSPACE=0 y a la derecha ICONLABELSPACE=10

SYMBOLWIDTH

Este parámetro permite especificar el ancho de la vista previa del símbolo en milímetros. Por defecto el valor de ancho es 7 mm.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries,
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&SYMBOLWIDTH=2
../../../_images/wms_getlegendgraphic_symbolwidth.png

Figura 3.11 A la izquierda SYMBOLWIDTH=2 y a la derecha SYMBOLWIDTH=20

SYMBOLHEIGHT

Este parámetro permite especificar la altura de la vista previa del símbolo en milímetros. Por defecto el valor de la altura es 4 mm.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries,
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&SYMBOLHEIGHT=2
../../../_images/wms_getlegendgraphic_symbolheight.png

Figura 3.12 A la izquierda SYMBOLHEIGHT=2 y a la derecha SYMBOLHEIGHT=6

LAYERTITLE

Este parámetro especifica si renderizar el título de la capa.

Valores disponibles son (no en caso sensitivo):

  • TRUE (valor predeterminado)

  • FALSE

LAYERFONTFAMILY

Este parámetro especifica la familia de fuentes que se usará para representar el título de la capa.

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries
&LAYERFONTFAMILY=monospace

LAYERFONTBOLD

Este parámetro especifica si el título de la capa se muestra en negrita. Los valores disponibles son (no distingue entre mayúsculas y minúsculas):

  • TRUE

  • FALSE

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&LAYERFONTBOLD=TRUE
../../../_images/wms_getlegendgraphic_layerfontbold.png

Figura 3.13 Leyenda con LAYERFONTBOLD=TRUE

LAYERFONTSIZE

Este parámetro especifica el tamaño de fuente para representar el título de la capa en el punto.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&LAYERFONTSIZE=20
../../../_images/wms_getlegendgraphic_layerfontsize.png

Figura 3.14 Leyenda con LAYERFONTSIZE=20

LAYERFONTITALIC

Este parámetro especifica si el título de la capa se representa en cursiva. Los valores disponibles son (no distingue entre mayúsculas y minúsculas):

  • TRUE

  • FALSE

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&LAYERFONTITALIC=TRUE
../../../_images/wms_getlegendgraphic_layerfontitalic.png

Figura 3.15 Leyenda con LAYERFONTITALIC=TRUE

LAYERFONTCOLOR

Este parámetro especifica el color del título de la capa. El color puede ser literal (red, green, ..) o en notación hexadecimal (0xFF0000, 0x00FF00, …).

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&LAYERFONTCOLOR=0x5f9930
../../../_images/wms_getlegendgraphic_layerfontcolor.png

Figura 3.16 Leyenda con LAYERFONTCOLOR=0x5f9930

ITEMFONTFAMILY

Este parámetro especifica la familia de fuentes que se usará para representar la etiqueta del elemento.

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=countries
&ITEMFONTFAMILY=monospace

ITEMFONTBOLD

Este parámetro especifica si la etiqueta del elemento se muestra en negrita. Los valores disponibles son (no distingue entre mayúsculas y minúsculas):

  • TRUE

  • FALSE

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&ITEMFONTBOLD=TRUE
../../../_images/wms_getlegendgraphic_itemfontbold.png

Figura 3.17 Leyenda con ITEMFONTBOLD=TRUE

ITEMFONTSIZE

Este parámetro especifica el tamaño de fuente para representar el título de la capa en el punto.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&ITEMFONTSIZE=20
../../../_images/wms_getlegendgraphic_itemfontsize.png

Figura 3.18 Leyenda con ITEMFONTSIZE=30

ITEMFONTITALIC

Este parámetro especifica si la etiqueta del elemento se muestra en cursiva. Los valores disponibles son (no distingue entre mayúsculas y minúsculas):

  • TRUE

  • FALSE

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&ITEMFONTITALIC=TRUE
../../../_images/wms_getlegendgraphic_itemfontitalic.png

Figura 3.19 Leyenda con ITEMFONTITALIC=TRUE

ITEMFONTCOLOR

Este parámetro especifica el color de la etiqueta del elemento. El color puede ser literal (red, green, ..) o en notación hexadecimal (0xFF0000, 0x00FF00, …).

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetLegendGraphic
&LAYERS=airports,places
&BBOX=43.20,-2.93,49.35,8.32
&CRS=EPSG:4326
&TRANSPARENT=TRUE
&ITEMFONTCOLOR=0x5f9930
../../../_images/wms_getlegendgraphic_itemfontcolor.png

Figura 3.20 Leyenda con ITEMFONTCOLOR=0x5f9930

ADDLAYERGROUPS

Este parámetro especifica si la salida JSON también mostrará los nombres de los grupos de capas (y subgrupos) en la entrada de la leyenda. Los valores posibles son:

  • TRUE: mostrar las etiquetas de los grupos

  • FALSE (predeterminado): ocultar las etiquetas de los grupos

../../../_images/wms_getlegendgraphic_addlayergroups.png

Figura 3.21 Leyenda sin visualización de etiquetas de grupos de capas (izquierda) y con visualización de etiquetas de grupos de capas (derecha)

La salida JSON correspondiente mostrando el nombre de los grupos tendría el siguiente aspecto:

{ "nodes":
  [{ "nodes":
     [{ "icon":"iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAUklEQVQ4jWNgGAXDHzASUqCsrPwfmX/37l28evBKKisr/0+a7IMiNi93C15DcUpgM4wYQ5nwuZAcMIQNvHv3LuO83C0kG0hysoFZRrJNo2AYAQC87BpkGQj1fwAAAABJRU5ErkJggg==",
        "title":"layer_a", "type":"layer"
     },
     { "nodes":
       [{ "icon":"iVBORw0KGgoAAAANSUhEUgAAABMAAAAUCAYAAABvVQZ0AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAHUlEQVQ4jWNgGAWjYCQDxh887r8G2hGjYBQMGAAA1x0CR0FzIkYAAAAASUVORK5CYII=",
          "title":"layer_b", "type":"layer"
        },
        { "icon":"iVBORw0KGgoAAAANSUhEUgAAABMAAAAUCAYAAABvVQZ0AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAHUlEQVQ4jWNgGAWjYCQDxtmzZ/8aaEeMglEwYAAAaIoCzTtn5XoAAAAASUVORK5CYII=",
          "title":"layer_c", "type":"layer"
       }],
       "title":"lines", "type":"group"
     },
     { "icon":"iVBORw0KGgoAAAANSUhEUgAAABMAAAATCAYAAAByUDbMAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAKklEQVQ4jWNUVlX/z0AlwMLAwMDAnXmQKoYxUcWUUcNGDRs1bNSwYWYYACXDAsvQaTuVAAAAAElFTkSuQmCC",
       "title":"layer_d", "type":"layer"
     }],
     "title":"top-level-group", "type":"group"
  }],
  "title":""
}

3.2.5. GetStyle(s)

Parámetros estándar para la solicitud GetStyle (o GetStyles) según las especificaciones OGC WMS 1.1.1:

Parámetros

Necesario

Descripción

SERVICE

Nombre del servicio (WMS)

REQUEST

Nombre de la solicitud (GetStyle o GetStyles)

LAYERS

Capas a consultar

La solicitud GetStyle también admite los siguientes parámetros de proveedor:

Parámetros

Necesario

Descripción

MAP

Archivo de proyecto QGIS

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetStyles
&LAYERS=mylayer1,mylayer2

3.2.6. DescribeLayer

Parámetros estándar para la solicitud DescribeLayer según las especificaciones OGC WMS 1.1.1 y 1.3.0:

Parámetros

Necesario

Descripción

SERVICE

Nombre del servicio (WMS)

REQUEST

Nombre de la solicitud (DescribeLayer)

LAYERS

Capas para describir

SLD_VERSION

versión SLD

La solicitud de DescribeLayer también admite los siguientes parámetros de proveedor:

Parámetros

Necesario

Descripción

MAP

Archivo de proyecto QGIS

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=DescribeLayer
&SLD_VERSION=1.1.0
&LAYERS=mylayer1

El documento XML se parece a:

<DescribeLayerResponse xmlns="http://www.opengis.net/sld" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ows="http://www.opengis.net/ows" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:se="http://www.opengis.net/se" xsi:schemaLocation="http://www.opengis.net/sld http://schemas.opengis.net/sld/1.1.0/DescribeLayer.xsd">
    <Version>1.1.0</Version>
    <LayerDescription>
        <owsType>wfs</owsType>
        <se:OnlineResource xlink:href="http://localhost/qgisserver" xlink:type="simple"/>
        <TypeName>
            <se:FeatureTypeName>my_vector_layer</se:FeatureTypeName>
        </TypeName>
    </LayerDescription>
    <LayerDescription>
        <owsType>wcs</owsType>
        <se:OnlineResource xlink:href="http://localhost/qgisserver" xlink:type="simple"/>
        <TypeName>
            <se:FeatureTypeName>my_raster_layer</se:FeatureTypeName>
        </TypeName>
    </LayerDescription>
</DescribeLayerResponse>

SLD_VERSION

Este parámetro permite especificar la versión de SLD. Solo está disponible el valor 1.1.0.

3.2.7. GetPrint

QGIS Server tiene la capacidad de crear una salida de diseño de impresión en formato pdf o píxel. Las ventanas de diseño de impresión del proyecto publicado se utilizan como plantillas. En la solicitud GetPrint, el cliente tiene la posibilidad de especificar parámetros de las etiquetas y mapas de diseño contenidos.

La solicitud GetPrint admite redlining, :ref:`external WMS Layers<wms_external> ` así como los siguientes parámetros:

Parámetros

Necesario

Descripción

MAP

Archivo de proyecto QGIS

SERVICE

Nombre del servicio (WMS)

REQUEST

Nombre de la solicitud (GetPrint)

VERSION

No

Versión del servicio

LAYERS

No

Capas a mostrar

TEMPLATE

Plantilla de diseño a usar

SRS / CRS

Sistema de referencia de coordenadas

FORMAT

No

Formato de salida

FORMAT_OPTIONS

No

Opciones del formato de archivo especificado

Sólo para FORMAT=application/pdf.

ATLAS_PK

No

Características del Atlas

STYLES

No

Estilo de capas

TRANSPARENT

No

fondo transparente

OPACITIES

No

Opacidad de la capa o Grupo

SELECTION

No

Resalta entidades

mapX:EXTENT

No

Extensión del mapa “X”

mapX:LAYERS

No

Capas del mapa “X”

mapX:STYLES

No

Estilo de capas del mapa “X”

mapX:SCALE

No

Escala de capas del mapa “X”

mapX:ROTATION

No

Rotación del mapa “X”

mapX:GRID_INTERVAL_X

No

Intervalo de cuadrícula en eje x del mapa “X”

mapX:GRID_INTERVAL_Y

No

Intervalo de cuadrícula en eje y del mapa “X”

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetPrint
&MAP=/home/qgis/projects/world.qgs
&CRS=EPSG:4326
&FORMAT=png
&TEMPLATE=Layout%201
&map0:EXTENT=-180,-90,180,90
&map0:LAYERS=mylayer1,mylayer2,mylayer3
&map0:OPACITIES=125,200,125
&map0:ROTATION=45

Tenga en cuenta que la plantilla de diseño puede contener más de un mapa. De esta forma, si quieres configurar un mapa específico, debes utilizar los parámetros mapX: donde X es un número positivo que puedes recuperar gracias a la solicitud GetProjectSettings.

Por ejemplo:

<WMS_Capabilities>
...
<ComposerTemplates xsi:type="wms:_ExtendedCapabilities">
<ComposerTemplate width="297" height="210" name="Druckzusammenstellung 1">
<ComposerMap width="171" height="133" name="map0"/>
<ComposerMap width="49" height="46" name="map1"/></ComposerTemplate>
</ComposerTemplates>
...
</WMS_Capabilities>

TEMPLATE

Este parámetro puede serr usado para especificar el nombre de la plantilla de composición a usar para la impresión.

FORMAT

Este parámetro especifica el formato de la imagen de mapa. Los valores disponibles son:

  • png (valor predeterminado)

  • image/png

  • jpg

  • jpeg

  • image/jpeg

  • svg

  • image/svg

  • image/svg+xml

  • pdf

  • application/pdf

Si el parámetro FORMAT es diferente de uno de estos valores, entonces se devuelve una excepción.

FORMAT_OPTIONS

Este parámetro puede utilizarse para especificar opciones para el formato seleccionado. Sólo para FORMAT=application/pdf en peticiones GetPrint. Toma una lista de pares clave:valor separados por punto y coma:

  • RASTERIZE_WHOLE_IMAGE: si todo el pdf debe exportarse como imagen. Predeterminado: falso.

  • FORCE_VECTOR_OUTPUT: si el pdf debe exportarse como vector. Predeterminado: falso.

  • APPEND_GEOREFERENCE: si se añadirá información de georeferencia al pdf. Predeterminado: verdadero.

  • EXPORT_METADATA: si se añadirán metadatos al pdf. Predeterminado: verdadero.

  • TEXT_RENDER_FORMAT: establece el formato de renderizado de texto para la exportación a pdf. Puede ser AlwaysOutlines (predeterminado) o AlwaysText.

  • SIMPLIFY_GEOMETRY: si se simplificarán las geometrías de los objetos espaciales. Predeterminado: verdadero.

  • WRITE_GEO_PDF: si se exportará un GeoPDF. Predeterminado: falso.

  • USE_ISO_32000_EXTENSION_FORMAT_GEOREFERENCING: si se utilizará la georreferenciación Iso32000. Predeterminado: falso.

  • USE_OGC_BEST_PRACTICE_FORMAT_GEOREFERENCING: si se utilizará la georreferenciación de las mejores prácticas OGC. Predeterminado: falso.

  • EXPORT_THEMES: una lista separada por comas de los temas de mapas que se utilizarán para la exportación GeoPDF

  • PREDEFINED_MAP_SCALES: una lista separada por comas de escalas de mapa para representar el mapa

  • LOSSLESS_IMAGE_COMPRESSION: si las imágenes incrustadas en pdf deben comprimirse utilizando un algoritmo sin pérdidas. Predeterminado: falso.

  • DISABLE_TILED_RASTER_RENDERING: si los rásters deben o no mostrarse en el pdf. Predeterminado: falso.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetPrint
&MAP=/home/qgis/projects/world.qgs
&CRS=EPSG:4326
&FORMAT=pdf
&TEMPLATE=Layout%201
&FORMAT_OPTIONS=FORCE_VECTOR_OUTPUT:TRUE;TEXT_RENDER_FORMAT:AlwaysOutlines;PREDEFINED_MAP_SCALES:250

ATLAS_PK

Este parámetro permite la activación del renderizado Atlas indicando qué características queremos imprimir. Para recuperar un atlas con todas las características, se puede usar el símbolo * (según el número máximo de características permitidas en la configuración del proyecto).

Cuando FORMATO es pdf, se devuelve un solo documento PDF que combina las páginas de funciones. Para todos los demás formatos, se devuelve una sola página.

mapX:EXTENT

Este parámetro especifica la extensión para un elemento del diseño de mapa como xmin,ymin,xmax,ymax.

mapX:ROTATION

Este parámetro especifica la rotación del mapa en grados.

mapX:GRID_INTERVAL_X

Este parámetro especifica la densidad de línea de cuadrícula en la dirección X.

mapX:GRID_INTERVAL_Y

Este parámetro especifica la densidad de línea de cuadrícula en la dirección Y.

mapX:SCALE

Este parámetro especifica la escala de mapa para un elemento de la composición de mapa. Es útil para asegurar la visibilidad basada en escala de capas y etiquetas incluso si el cliente y servidor puedan tener diferentes algoritmos para calcular el denominador de escala.

mapX:LAYERS

Este parámetro especifica las capas para un elemento de mapa de diseño. Consulte GetMap Layers para obtener más información sobre este parámetro.

mapX:STYLES

Este parámetro especifica los estilos de las capas definidos en un elemento de mapa de diseño específico. Consulte GetMap Styles para obtener más información sobre este parámetro.

3.2.8. GetProjectSettings

Este tipo de solicitud funciona de manera similar a GetCapabilities, pero es más específico para QGIS Server y permite que un cliente lea información adicional que no está disponible en la salida de GetCapabilities:

  • visibilidad inicial de las capas

  • información acerca de atributos vectoriales y sus tipos de edición

  • información acerca de orden de capa y orden de dibujado

  • lista de capas publicadas en WFS

  • mostrar si un grupo en el árbol de capas es mutuamente exclusivo

La solicitud GetProjectSettings admite los siguientes parámetros:

Parámetros

Necesario

Descripción

MAP

Archivo de proyecto QGIS

SERVICE

Nombre del servicio (WMS)

REQUEST

Nombre de la solicitud (GetProjectSettings)

3.2.9. GetSchemaExtension

La solicitud GetSchemaExtension permite recuperar capacidades y operaciones extendidas opcionales del servicio WMS, como las implementadas por QGIS Server.

Parámetros

Necesario

Descripción

MAP

Archivo de proyecto QGIS

SERVICE

Nombre del servicio (WMS)

REQUEST

Nombre de la solicitud (GetSchemaExtension)

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetSchemaExtension

El documento XML se parece a:

<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:wms="http://www.opengis.net/wms" xmlns:qgs="http://www.qgis.org/wms" targetNamespace="http://www.qgis.org/wms" elementFormDefault="qualified" version="1.0.0">
    <import namespace="http://www.opengis.net/wms" schemaLocation="http://schemas.opengis.net/wms/1.3.0/capabilities_1_3_0.xsd"/>
    <element name="GetPrint" type="wms:OperationType" substitutionGroup="wms:_ExtendedOperation"/>
    <element name="GetStyles" type="wms:OperationType" substitutionGroup="wms:_ExtendedOperation"/>
</schema>

3.2.10. Capas WMS Externas

QGIS Server permite incluir capas de servidores WMS externos en solicitudes WMS GetMap y WMS GetPrint. Esto es especialmente útil si un cliente web usa una capa de fondo externa en el mapa web. Por razones de rendimiento, dichas capas deben ser solicitadas directamente por el cliente web (no en cascada a través del servidor QGIS). Sin embargo, para imprimir, estas capas deben conectarse en cascada a través del servidor QGIS para que aparezcan en el mapa impreso.

Las capas externas se pueden agregar al parámetro LAYERS como EXTERNAL_WMS<layername>:. Los parámetros para las capas WMS externas (por ejemplo, url, formato, dpiMode, crs, capas, estilos) se pueden proporcionar más tarde como parámetros de servicio <layername>:<parameter>. En una solicitud GetMap, esto podría verse así:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&LAYERS=EXTERNAL_WMS:basemap,layer1,layer2
&OPACITIES=100,200,255
&STYLES=,,
&basemap:url=http://externalserver.com/wms.fcgi
&basemap:format=image/jpeg
&basemap:dpiMode=7
&basemap:crs=EPSG:2056
&basemap:layers=orthofoto
&basemap:styles=default

De manera similar, las capas externas se pueden usar en las solicitudes GetPrint:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetPrint
&TEMPLATE=A4
&map0:layers=EXTERNAL_WMS:basemap,layer1,layer2
&map0:EXTENT=<minx,miny,maxx,maxy>
&OPACITIES=100,200,255
&basemap:url=http://externalserver.com/wms.fcgi
&basemap:format=image/jpeg
&basemap:dpiMode=7
&basemap:crs=EPSG:2056
&basemap:layers=orthofoto
&basemap:styles=default

3.2.11. Redlining

Esta función está disponible y se puede utilizar con solicitudes GetMap y GetPrint.

La función de marcación roja se puede utilizar para pasar geometrías y etiquetas en la solicitud que el servidor superpone sobre la imagen devuelta estándar (mapa). Esto permite al usuario poner énfasis o quizás agregar algunos comentarios (etiquetas) a algunas áreas, ubicaciones, etc. que no están en el mapa estándar.

La solicitud GetMap tiene el formato:

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetMap
&HIGHLIGHT_GEOM=POLYGON((590000 5647000, 590000 6110620, 2500000 6110620, 2500000 5647000, 590000 5647000))
&HIGHLIGHT_SYMBOL=<StyledLayerDescriptor><UserStyle><Name>Highlight</Name><FeatureTypeStyle><Rule><Name>Symbol</Name><LineSymbolizer><Stroke><SvgParameter name="stroke">%23ea1173</SvgParameter><SvgParameter name="stroke-opacity">1</SvgParameter><SvgParameter name="stroke-width">1.6</SvgParameter></Stroke></LineSymbolizer></Rule></FeatureTypeStyle></UserStyle></StyledLayerDescriptor>
&HIGHLIGHT_LABELSTRING=Write label here
&HIGHLIGHT_LABELSIZE=16
&HIGHLIGHT_LABELCOLOR=%23000000
&HIGHLIGHT_LABELBUFFERCOLOR=%23FFFFFF
&HIGHLIGHT_LABELBUFFERSIZE=1.5

El equivalente GetPrint está en el formato (tenga en cuenta que se agrega el parámetro mapX: para indicar qué mapa tiene líneas rojas):

http://localhost/qgisserver?
SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetPrint
&map0:HIGHLIGHT_GEOM=POLYGON((590000 5647000, 590000 6110620, 2500000 6110620, 2500000 5647000, 590000 5647000))
&map0:HIGHLIGHT_SYMBOL=<StyledLayerDescriptor><UserStyle><Name>Highlight</Name><FeatureTypeStyle><Rule><Name>Symbol</Name><LineSymbolizer><Stroke><SvgParameter name="stroke">%23ea1173</SvgParameter><SvgParameter name="stroke-opacity">1</SvgParameter><SvgParameter name="stroke-width">1.6</SvgParameter></Stroke></LineSymbolizer></Rule></FeatureTypeStyle></UserStyle></StyledLayerDescriptor>
&map0:HIGHLIGHT_LABELSTRING=Write label here
&map0:HIGHLIGHT_LABELSIZE=16
&map0:HIGHLIGHT_LABELCOLOR=%23000000
&map0:HIGHLIGHT_LABELBUFFERCOLOR=%23FFFFFF
&map0:HIGHLIGHT_LABELBUFFERSIZE=1.5

Aquí está la imagen obtenida por la solicitud anterior en la que se dibujan un polígono y una etiqueta sobre el mapa normal:

../../../_images/server_redlining.png

Figura 3.22 Respuesta del servidor a una solicitud GetMap con parámetros de marcado

Puede ver que hay varios parámetros en esta solicitud para controlar la función de redlining. La lista completa incluye:

  • HIGHLIGHT_GEOM: Puede añadir POINT, MULTILINESTRING, POLYGON etc. Admite geometrías multiparte. Aquí hay un ejemplo: HIGHLIGHT_GEOM=MULTILINESTRING((0 0, 0 1, 1 1)). Las coordenadas deben estar en el SRC de la solicitud GetMap/GetPrint.

  • HIGHLIGHT_LABELBUFFERCOLOR: Este parámetro controla el color del búfer de etiquetas.

  • HIGHLIGHT_LABELBUFFERSIZE: Este parámetro controla el tamaño del búfer de etiquetas.

  • HIGHLIGHT_LABELCOLOR: Este parámetro controla el color de la etiqueta.

  • HIGHLIGHT_LABEL_DISTANCE: controla la distancia entre el elemento (por ejemplo, un punto o una línea) y la etiqueta en mm.

  • HIGHLIGHT_LABELFONT: Este parámetro controla la fuente de la etiqueta (por ejemplo, Arial)

  • HIGHLIGHT_LABEL_HORIZONTAL_ALIGNMENT: coloca la etiqueta horizontalmente en un punto utilizando la alineación especificada (por ejemplo, “izquierda”, “centro”, “derecha”)

  • HIGHLIGHT_LABEL_ROTATION: controla la rotación de la etiqueta en grados

  • HIGHLIGHT_LABELSIZE: Este parámetro controla el tamaño de la etiqueta.

  • HIGHLIGHT_LABELSTRING: Puede pasar su texto de etiquetado a este parámetro.

  • HIGHLIGHT_LABEL_VERTICAL_ALIGNMENT: coloca la etiqueta verticalmente en un punto utilizando la alineación especificada (por ejemplo, “arriba”, “mitad”, “abajo”)

  • HIGHLIGHT_SYMBOL: Esto controla cómo se perfila la geometría y puede cambiar el ancho, el color y la opacidad del trazo.