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

Nombre del servicio (WCS)

REQUEST

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

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

Nombre del servicio (WCS)

REQUEST

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

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

Nombre del servicio (WCS)

REQUEST

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

Ancho de la respuesta en píxeles

HEIGHT

Altura de la respuesta en píxeles

BBOX

Extensión del mapa en unidades CRS

CRS

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

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.

../../../_images/server_wcs_getcoverage_width_height.png

Figura 3.22 De izquierda a derecha: ANCHO=20&ALTO=20, ANCHO=50&ALTO=50, ANCHO=100&ALTO=100