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	Sì	Nome del servizio (WCS)
REQUEST	Sì	Nome della richiesta (GetCapabilities)
VERSION	No	Versione del servizio

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

Parametro	Richiesto	Descrizione
MAP	Sì	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	Sì	Nome del servizio (WCS)
REQUEST	Sì	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	Sì	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	Sì	Nome del servizio (WCS)
REQUEST	Sì	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	Sì	Larghezza della risposta in pixel
HEIGHT	Sì	Altezza della risposta in pixel
BBOX	Sì	Estensione della mappa in unità SR
CRS	Sì	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	Sì	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.