3.4. Web Coverage Service (WCS)

De WCS standaarden 1.0.0 en 1.1.1 die zijn geïmplementeerd in QGIS Server verschaffen een HTTP-interface voor toegang tot rastergegevens, waarnaar wordt verwezen als coverage, komende uit een project van QGIS.

Specificaties:

Standaardverzoeken verschaft door QGIS Server:

Verzoek	Omschrijving
GetCapabilities	Geeft XML-metadata terug met informatie over de server
DescribeCoverage	Haalt XML-document op over aanvullende informatie over coverages
GetCoverage	Haalt coverage op

3.4.1. GetCapabilities

Standaardparameters voor het verzoek GetCapabilities overeenkomstig de specificaties van OGC WCS 1.1.1:

Parameter	Vereist	Omschrijving
SERVICE	Ja	Naam van de service (WCS)
REQUEST	Ja	Naam van het verzoek (GetCapabilities)
VERSION	Nee	Versie van de service

In aanvulling op de standaard parameters ondersteunt QGIS Server de volgende extra parameters:

Parameter	Vereist	Omschrijving
MAP	Ja	QGIS projectbestand

Voorbeeld URL:

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

Voorbeeld XML-document wanneer één enkele rasterlaag (genaamd T20QPD_20171123T144719_TCI) is gepubliceerd in het project van QGIS voor de service 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

Deze parameter maakt het mogelijk de te gebruiken versie van de service te specificeren. Momenteel worden de versiewaarden intern niet gebruikt en valt altijd terug op 1.1.1.

3.4.2. DescribeCoverage

Dit verzoek maakt het mogelijk aanvullende informatie op te halen over coverages, zoals de indeling van de onderliggende databron, het aantal banden, … Standaardparameters voor het verzoek DescribeCoverage overeenkomstig de specificaties voor OGC WCS 1.1.1:

Parameter	Vereist	Omschrijving
SERVICE	Ja	Naam van de service (WCS)
REQUEST	Ja	Naam van het verzoek (DescribeCoverage)
VERSION	Nee	Versie van de service
COVERAGE	Nee	Coverage-lagen specificeren (WCS 1.0.0)
IDENTIFIER	Nee	Coverage-lagen specificeren (WCS 1.1.1)

In aanvulling op de standaard parameters ondersteunt QGIS Server de volgende extra parameters:

Parameter	Vereist	Omschrijving
MAP	Ja	QGIS projectbestand

Het XML-document voor een 3-bands GeoTIFF rasterlaag ziet eruit als:

<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

Deze parameter, gedefinieerd in WCS 1.0.0, maakt het mogelijk de te bevragen lagen voor aanvullende informatie te specificeren. Namen moeten worden gescheiden door een komma.

In aanvulling daarop introduceerde QGIS Server een optie om lagen te selecteren op hun korte naam. De korte naam van een laag kan worden geconfigureerd via Eigenschappen ► Metadata in het laagmenu. Als de korte naam is gedefinieerd, dan wordt die standaard gebruikt in plaats van de laagnaam:

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

Notitie

COVERAGE is verplicht als IDENTIFIER niet is ingesteld.

IDENTIFIER

Deze parameter vervangt de parameter COVERAGE in WCS 1.1.1. Maar QGIS Server filtert niet overeenkomstig de parameter VERSION dus hebben IDENTIFIER en COVERAGE hetzelfde effect.

Notitie

IDENTIFIER is verplicht als COVERAGE niet is ingesteld. Als beide parameters IDENTIFIER en COVERAGE zijn gedefinieerd, wordt COVERAGE altijd met prioriteit gebruikt.

3.4.3. GetCoverage

Dit verzoek maakt het mogelijk de coverage op te halen overeenkomstig specifieke beperkingen, zoals het bereik of het CRS. Standaardparameters voor het verzoek DescribeCoverage overeenkomstig de specificaties voor OGC WCS 1.1.1:

Parameter	Vereist	Omschrijving
SERVICE	Ja	Naam van de service (WCS)
REQUEST	Ja	Naam van het verzoek (GetCoverage)
VERSION	Nee	Versie van de service
COVERAGE	Nee	Coverage-lagen specificeren (WCS 1.0.0)
IDENTIFIER	Nee	Coverage-lagen specificeren (WCS 1.1.1)
WIDTH	Ja	Breedte van het antwoord in pixels
HEIGHT	Ja	Hoogte van het antwoord in pixels
BBOX	Ja	Kaartbereik in eenheden van het CRS
CRS	Ja	Coördinaten referentiesysteem van het bereik
RESPONSE_CRS	Nee	Coördinaten referentiesysteem van het antwoord

In aanvulling op de standaard parameters ondersteunt QGIS Server de volgende extra parameters:

Parameter	Vereist	Omschrijving
MAP	Ja	QGIS projectbestand

BBOX

Deze parameter maakt het mogelijk het kaartbereik te specificeren in de eenheden van het huidige CRS. Coördinaten moeten worden gescheiden door een komma. De parameter BBOX wordt gevormd als minx,miny,maxx,maxy.

Voorbeeld URL:

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

CRS

Deze parameter maakt het mogelijk het Ruimtelijke ReferentieSysteem van de parameter BBOX aan te geven en moet zijn gevormd als EPSG:XXXX.

RESPONSE_CRS

Deze parameter maakt het mogelijk het Ruimtelijke ReferentieSysteem voor het uitvoer-antwoord aan te geven en moet worden gevormd als EPSG:XXXX. Het CRS van de corresponderende coverage-laag wordt standaard gebruikt.

WIDTH

Deze parameter maakt het mogelijk de breedte in pixels van de uitvoer-afbeelding te specificeren De resolutie van de antwoord-afbeelding is afhankelijk van deze waarde.

HEIGHT

Deze parameter maakt het mogelijk de hoogte in pixels van de uitvoer-afbeelding te specificeren De resolutie van de antwoord-afbeelding is afhankelijk van deze waarde.