3.4. Web Coverage Service (WCS)

Gli standard WCS 1.0.0 e 1.1.1 implementati in QGIS Server forniscono un’interfaccia HTTP per accedere ai dati raster, denominati coverage, provenienti da un progetto QGIS.

Specifiche:

Richieste standard fornite da QGIS Server:

Request

Descrizione

GetCapabilities

Restituisce metadati XML con informazioni sul server

DescribeCoverage

Recupera il documento XML relativo alle informazioni aggiuntive sulle coverages.

GetCoverage

Recupera coverage

3.4.1. GetCapabilities

Parametri standard per la richiesta GetCapabilities in conformità alle specifiche OGC WCS 1.1.1:

Parametro

Richiesto

Descrizione

SERVICE

Nome del servizio (WCS)

REQUEST

Nome della richiesta (GetCapabilities)

VERSION

No

Versione del servizio

Oltre a quelli standard, QGIS Server supporta i seguenti parametri extra:

Parametro

Richiesto

Descrizione

MAP

File di progetto QGIS

Esempio di URL:

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

Esempio di documento XML quando un singolo layer raster (denominato T20QPD_20171123T144719_TCI) viene pubblicato nel progetto QGIS per il servizio 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

Questo parametro consente di specificare la versione del servizio da utilizzare. Attualmente, i valori della versione non sono utilizzati internamente e sono sempre di riferimento a 1.1.1.

3.4.2. DescribeCoverage

Questa richiesta consente di recuperare informazioni aggiuntive sulle coperture, come il formato della fonte di dati sottostante, il numero di bande, … Parametri standard per la richiesta DescribeCoverage secondo le specifiche OGC WCS 1.1.1:

Parametro

Richiesto

Descrizione

SERVICE

Nome del servizio (WCS)

REQUEST

Nome della richiesta (DescribeCoverage)

VERSION

No

Versione del servizio

COVERAGE

No

Specificare i layer coverage (WCS 1.0.0)

IDENTIFIER

No

Specificare layer coverage (WCS 1.1.1)

Oltre a quelli standard, QGIS Server supporta i seguenti parametri extra:

Parametro

Richiesto

Descrizione

MAP

File di progetto QGIS

Il documento XML per un layer raster GeoTIFF a 3 bande si presenta come segue:

<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

Questo parametro, definito in WCS 1.0.0, consente di specificare i layer da interrogare per ottenere informazioni aggiuntive. I nomi devono essere separati da una virgola.

Inoltre, QGIS Server ha introdotto un’opzione per selezionare i layer in base al loro nome breve. Il nome breve di un layer può essere configurato tramite :menuselection: Proprietà –> Metadati nel menu dei layer. Se il nome breve è definito, viene utilizzato per impostazione predefinita al posto del nome del layer:

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

Nota

COVERAGE è obbligatorio se IDENTIFIER non è impostato.

IDENTIFIER

Questo parametro sostituisce il parametro COVERAGE in WCS 1.1.1. Ma QGIS Server non filtra in base al parametro VERSION, quindi IDENTIFIER e COVERAGE hanno lo stesso effetto.

Nota

IDENTIFIER è obbligatorio se COVERAGE non è impostato. Se sono definiti entrambi i parametri IDENTIFIER e COVERAGE, COVERAGE è sempre usato in modo prioritario.

3.4.3. GetCoverage

Questa richiesta consente di recuperare la copertura in base a vincoli specifici come l’estensione o il SR. Parametri standard per la richiesta DescribeCoverage secondo le specifiche OGC WCS 1.1.1:

Parametro

Richiesto

Descrizione

SERVICE

Nome del servizio (WCS)

REQUEST

Nome della richiesta (GetCoverage)

VERSION

No

Versione del servizio

COVERAGE

No

Specificare i layer coverage (WCS 1.0.0)

IDENTIFIER

No

Specificare layer coverage (WCS 1.1.1)

WIDTH

Larghezza della risposta in pixel

HEIGHT

Altezza della risposta in pixel

BBOX

Estensione della mappa in unità SR

CRS

Sistema di riferimento delle coordinate dell’estensione

RESPONSE_CRS

No

Sistema di riferimento delle coordinate della risposta

Oltre a quelli standard, QGIS Server supporta i seguenti parametri extra:

Parametro

Richiesto

Descrizione

MAP

File di progetto QGIS

BBOX

Questo parametro consente di specificare l’estensione della mappa nelle unità del SR corrente. Le coordinate devono essere separate da una virgola. Il parametro BBOX è formato come minx,miny,maxx,maxy.

Esempio di URL:

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

CRS

Questo parametro permette di indicare il sistema di riferimento spaziale del parametro BBOX e deve essere formato come EPSG:XXXX.

RESPONSE_CRS

Questo parametro consente di indicare il sistema di riferimento spaziale della risposta in uscita e deve essere formato come EPSG:XXXX. Per impostazione predefinita, viene utilizzato il SR del layer coverage corrispondente.

WIDTH

Questo parametro consente di specificare la larghezza in pixel dell’immagine in uscita. La risoluzione dell’immagine risultante dipende da questo valore.

HEIGHT

Questo parametro consente di specificare l’altezza in pixel dell’immagine in uscita. La risoluzione dell’immagine risultante dipende da questo valore.

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

Fig. 3.22 Da sinistra a destra: WIDTH=20&HEIGHT=20, WIDTH=50&HEIGHT=50, WIDTH=100&HEIGHT=100