3.1. Básicos

En esta sección se describen conceptos y parámetros compartidos entre sí por los servicios. Algunos de estos son estándar y están definidos en las especificaciones de OGC, mientras que otros son muy específicos de QGIS Server.

Conceptos estándar:

Concepto

Descripción

SERVICE

Nombre del servicio

REQUEST

Nombre de la petición

Conceptos de proveedores:

Concepto

Descripción

MAP

Archivo de proyecto QGIS

FILE_NAME

Nombre de archivo de la capa descargada

Short name

Definición de nombre corto

3.1.1. SERVICE

Este parámetro estándar permite especificar el nombre del servicio a utilizar para una request específica y tiene que formarse como SERVICIO=NOMBRE.

Ejemplo de URL para el servicio WMS:

http://localhost/qgisserver?
SERVICE=WMS
&...

Nota

No disponible para servicios basados en DESCANSO como WFS3 (OGC API Features).

3.1.2. REQUEST

Este parámetro estándar permite especificar el nombre de la solicitud a ejecutar para un service específico y debe formarse como SOLICITUD=NombreSolicitud..

Ejemplo de URL para la solicitud GetCapabilities:

http://localhost/qgisserver?
REQUEST=GetCapabilities
&...

Nota

No disponible para servicios basados en DESCANSO como WFS3 (OGC API Features).

3.1.3. MAP

Este parámetro de proveedor permite definir el archivo de proyecto de QGIS a utilizar. Puede ser una ruta absoluta o una ruta relativa a la ubicación del ejecutable del servidor qgis_mapserv.fcgi. MAP es obligatorio por defecto porque una solicitud necesita un proyecto QGIS para funcionar. Sin embargo, la variable de entorno QGIS_PROJECT_FILE puede usarse para definir un proyecto QGIS predeterminado. En este caso específico, MAP ya no es un parámetro obligatorio. Para más información puede consultar el capítulo Canfiguración avanzada.

URL ejemplo:

http://localhost/qgisserver?
MAP=/tmp/QGIS-Training-Data/exercise_data/qgis-server-tutorial-data/world.qgs
&...

3.1.4. FILE_NAME

Si se establece este parámetro de proveedor, la respuesta del servidor se enviará al cliente como un archivo adjunto con el nombre de archivo especificado.

Ejemplo de URL para guardar un documento XML GetCapabilities:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetCapabilities
&FILE_NAME=wms_capabilities.xml
&...

Nota

No disponible para servicios basados en DESCANSO como WFS3 (OGC API Features).

3.1.5. Nombre corto

Varios elementos tienen tanto un nombre corto como un título. El nombre abreviado es una cadena de texto utilizada para la comunicación de máquina a máquina, mientras que el título es para beneficio de los humanos. Por ejemplo, un conjunto de datos puede tener el título descriptivo “Temperatura atmosférica máxima” y solicitarse con el nombre corto abreviado “ATMAX”. Puede establecer el título, el nombre corto y el resumen para:

  • Capas: haga clic con el botón derecho en una capa y seleccione Propiedades… ► Servidor QGIS ► Descripción.

  • Grupos: haga clic con el botón derecho en un grupo y seleccione Establecer datos WMS del grupo

  • Proyecto: vaya a Proyecto ► Propiedades… ► Servidor QGIS ► Capacidades de servicio.

../../../_images/set_group_wms_data.png

Figura 3.1 Establecer cuadro de diálogo de datos WMS de grupo

Por lo tanto, el nombre corto puede usarse para identificar estos elementos al interactuar con QGIS Server. Por ejemplo con el parámetro CAPAS estándar:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&LAYERS=shortname1,shortname2
&...