3.4. Servicio de cobertura web (WCS)

Los estándares WCS 1.0.0 y 1.1.1 implementados en QGIS Server proporcionan una interfaz HTTP para acceder a datos ráster, denominados cobertura, provenientes de un proyecto QGIS.

Especificaciones:

Solicitudes standard proporcionadas por el servidor QGIS:

Solicitud	Descripción
GetCapabilities	Devuelve metadatos XML con información sobre el servidor
DescribeCoverage	Recupera documento XML sobre información adicional sobre coberturas
GetCoverage	Recupera cobertura

3.4.1. GetCapabilities

Parámetros estándar para la solicitud Obtener Capacidades según las especificaciones OGC WCS 1.1.1:

Parámetros	Necesario	Descripción
SERVICE	Sí	Nombre del servicio (WCS)
REQUEST	Sí	Nombre de la solicitud (Obtener Capacidades)
VERSION	No	Versión del servicio

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

Parámetros	Necesario	Descripción
MAP	Sí	archivo de proyecto QGIS

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WCS
&VERSION=1.1.1
&REQUEST=GetCapabilities

Ejemplo de documento XML cuando se publica una sola capa ráster (llamada T20QPD_20171123T144719_TCI) en el proyecto QGIS para el servicio WCS:

<WCS_Capabilities xmlns="http://www.opengis.net/wcs" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:gml="http://www.opengis.net/gml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0.0" updateSequence="0" xsi:schemaLocation="http://www.opengis.net/wcs http://schemas.opengis.net/wcs/1.0.0/wcsCapabilities.xsd">
  <Service>
    ...
  </Service>
  <Capability>
    ...
  </Capability>
  <ContentMetadata>
    <CoverageOfferingBrief>
      <name>T20QPD_20171123T144719_TCI</name>
      <label>T20QPD_20171123T144719_TCI</label>
      <lonLatEnvelope srsName="urn:ogc:def:crs:OGC:1.3:CRS84">
        <gml:pos>-61.585973 16.331189</gml:pos>
        <gml:pos>-61.52537 16.400376</gml:pos>
      </lonLatEnvelope>
    </CoverageOfferingBrief>
  </ContentMetadata>
</WCS_Capabilities>

VERSION

Este parámetro permite especificar la versión del servicio a utilizar. Actualmente, los valores de la versión no se usan internamente y siempre se recurre a 1.1.1.

3.4.2. DescribeCoverage

Esta solicitud permite recuperar información adicional sobre coberturas como el formato de la fuente de datos subyacente, el número de bandas, … Parámetros estándar para la solicitud Describir Cobertura según las especificaciones OGC WCS 1.1.1:

Parámetros	Necesario	Descripción
SERVICE	Sí	Nombre del servicio (WCS)
REQUEST	Sí	Nombre de la solicitud (DescribeCobertura)
VERSION	No	Versión del servicio
COVERAGE	No	Especificar capas de cobertura (WCS 1.0.0)
IDENTIFIER	No	Especificar capas de cobertura (WCS 1.1.1)

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

Parámetros	Necesario	Descripción
MAP	Sí	archivo de proyecto QGIS

El documento XML para una capa ráster GeoTIFF de 3 bandas se ve así:

<CoverageDescription xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.opengis.net/wcs" xmlns:gml="http://www.opengis.net/gml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" updateSequence="0" version="1.0.0" xsi:schemaLocation="http://www.opengis.net/wcs http://schemas.opengis.net/wcs/1.0.0/describeCoverage.xsd">
  <CoverageOffering>
    <name>T20QPD_20171123T144719_TCI</name>
    <label>T20QPD_20171123T144719_TCI</label>
    <lonLatEnvelope srsName="urn:ogc:def:crs:OGC:1.3:CRS84">
      ...
    </lonLatEnvelope>
    <domainSet>
      ...
    </domainSet>
    <rangeSet>
      <RangeSet>
        <name>Bands</name>
        <label>Bands</label>
        <axisDescription>
          <AxisDescription>
            <name>bands</name>
            <label>bands</label>
            <values>
              <singleValue>1</singleValue>
              <singleValue>2</singleValue>
              <singleValue>3</singleValue>
            </values>
          </AxisDescription>
        </axisDescription>
      </RangeSet>
    </rangeSet>
    <supportedCRSs>
    ...
    </supportedCRSs>
    <supportedFormats nativeFormat="raw binary">
      <formats>GeoTIFF</formats>
    </supportedFormats>
  </CoverageOffering>
</CoverageDescription>

COVERAGE

Este parámetro, definido en WCS 1.0.0, permite especificar las capas a consultar para obtener información adicional. Los nombres tienen que estar separados por una coma.

Además, QGIS Server introdujo una opción para seleccionar capas por su nombre corto. El nombre corto de una capa se puede configurar a través de Propiedades ► Metadatos en el menú de la capa. Si se define el nombre abreviado, se usa de forma predeterminada en lugar del nombre de la capa:

http://localhost/qgisserver?
SERVICE=WCS
&REQUEST=DescribeCoverage
&COVERAGE=mylayer1name,mylayer2shortname

Nota

COBERTURA` es obligatorio si` IDENTIFICADOR` no está configurado.

IDENTIFIER

Este parámetro reemplaza el COVERAGE parámetro en WCS 1.1.1. Pero QGIS Server no filtra según el parámetro VERSION por lo que IDENTIFIER y COVERAGE tienen el mismo efecto.

Nota

IDENTIFICADOR es obligatorio si COBERTURA no está configurada. Si se definen los parámetros IDENTIFIER y COVERAGE, COVERAGE se usa siempre con prioridad.

3.4.3. GetCoverage

Esta solicitud permite recuperar la cobertura de acuerdo con restricciones específicas como la extensión o el CRS. Parámetros estándar para la solicitud DescribeCobertura según las especificaciones OGC WCS 1.1.1:

Parámetros	Necesario	Descripción
SERVICE	Sí	Nombre del servicio (WCS)
REQUEST	Sí	Nombre de la solicitud (Obtener Cobertura)
VERSION	No	Versión del servicio
COVERAGE	No	Especificar capas de cobertura (WCS 1.0.0)
IDENTIFIER	No	Especificar capas de cobertura (WCS 1.1.1)
WIDTH	Sí	Ancho de la respuesta en píxeles
HEIGHT	Sí	Altura de la respuesta en píxeles
BBOX	Sí	Extensión del mapa en unidades CRS
CRS	Sí	Sistema de referencia de coordenadas de la extensión
RESPONSE_CRS	No	Sistema de referencia de coordenadas de la respuesta

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

Parámetros	Necesario	Descripción
MAP	Sí	archivo de proyecto QGIS

BBOX

Este parámetro permite especificar la extensión del mapa en las unidades del CRS actual. Las coordenadas tienen que estar separadas por una coma. El parámetro BBOX se forma como minx,miny,maxx,maxy.

URL ejemplo:

http://localhost/qgisserver?
SERVICE=WCS
&REQUEST=GetCoverage
&IDENTIFIER=T20QPD_20171123T144719_TCI
&BBOX=647533,1805950,660987,1813940
&CRS=EPSG:32620

CRS

Este parámetro permite indicar el Sistema de Referencia Espacial del parámetro BBOX y tiene que formarse como EPSG:XXXX.

RESPONSE_CRS

Este parámetro permite indicar la respuesta de salida del Sistema de Referencia Espacial y tiene que formarse como EPSG:XXXX. El CRS de la capa de cobertura correspondiente se utiliza por defecto.

WIDTH

Este parámetro permite especificar el ancho en píxeles de la imagen de salida. La resolución de la imagen de respuesta depende de este valor.

HEIGHT

Este parámetro permite especificar la altura en píxeles de la imagen de salida. La resolución de la imagen de respuesta depende de este valor.