Viktigt

Översättning är en gemenskapsinsats du kan gå med i. Den här sidan är för närvarande översatt till 100.00%.

3.4. Webbtäckningstjänst (WCS)

WCS-standarderna 1.0.0 och 1.1.1 som implementerats i QGIS Server tillhandahåller ett HTTP-gränssnitt för åtkomst till rasterdata, som kallas täckning, som kommer från ett QGIS-projekt.

Specifikationer:

Standardförfrågningar som tillhandahålls av QGIS Server:

Förfrågan	Beskrivning
GetCapabilities	Returnerar XML-metadata med information om servern
DescribeCoverage	Hämtar XML-dokument med ytterligare information om försäkringar
GetCoverage	Hämtar täckning

3.4.1. GetCapabilities

Standardparametrar för GetCapabilities-begäran enligt OGC WCS 1.1.1-specifikationerna:

Parameter	Obligatorisk	Beskrivning
SERVICE	Ja	Tjänstens namn (WCS)
REQUEST	Ja	Namn på begäran (GetCapabilities)
VERSION	Nej	Version av tjänsten

Utöver standardparametrarna har QGIS Server stöd för följande extra parametrar:

Parameter	Obligatorisk	Beskrivning
MAP	Ja	QGIS-projektfil

Exempel på URL:

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

Exempel på XML-dokument när ett enda rasterlager (med namnet T20QPD_20171123T144719_TCI) publiceras i QGIS-projektet för WCS-tjänsten:

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

Denna parameter gör det möjligt att ange vilken version av tjänsten som ska användas. För närvarande används inte versionsvärdena internt och faller alltid tillbaka på 1.1.1.

3.4.2. DescribeCoverage

Denna begäran gör det möjligt att hämta ytterligare information om täckningar, t.ex. formatet för den underliggande datakällan, antalet band, … Standardparametrar för begäran DescribeCoverage enligt OGC WCS 1.1.1-specifikationerna:

Parameter	Obligatorisk	Beskrivning
SERVICE	Ja	Tjänstens namn (WCS)
REQUEST	Ja	Namn på begäran (DescribeCoverage)
VERSION	Nej	Version av tjänsten
COVERAGE	Nej	Ange täckningslager (WCS 1.0.0)
IDENTIFIER	Nej	Ange täckningslager (WCS 1.1.1)

Utöver standardparametrarna har QGIS Server stöd för följande extra parametrar:

Parameter	Obligatorisk	Beskrivning
MAP	Ja	QGIS-projektfil

XML-dokumentet för ett GeoTIFF-rasterlager med 3 band ser ut som följer:

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

Denna parameter, som definieras i WCS 1.0.0, gör det möjligt att ange vilka lager som ska tillfrågas om ytterligare information. Namnen måste separeras med ett kommatecken.

Dessutom har QGIS Server infört ett alternativ för att välja lager efter dess kortnamn. Kortnamnet för ett lager kan konfigureras genom Properties ► Metadata i lagermenyn. Om kortnamnet är definierat används det som standard i stället för lagrets namn:

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

Observera

COVERAGE är obligatoriskt om IDENTIFIER inte är angivet.

IDENTIFIER

Denna parameter ersätter parametern COVERAGE i WCS 1.1.1. Men QGIS Server filtrerar inte enligt parametern VERSION så IDENTIFIER och COVERAGE har samma effekt.

Observera

IDENTIFIER är obligatorisk om COVERAGE inte har angetts. Om både parametrarna IDENTIFIER och COVERAGE är definierade, används alltid COVERAGE i första hand.

3.4.3. GetCoverage

Denna begäran gör det möjligt att hämta täckningen enligt specifika begränsningar, t.ex. omfattning eller CRS. Standardparametrar för DescribeCoverage-begäran enligt OGC WCS 1.1.1-specifikationerna:

Parameter	Obligatorisk	Beskrivning
SERVICE	Ja	Tjänstens namn (WCS)
REQUEST	Ja	Namn på begäran (GetCoverage)
VERSION	Nej	Version av tjänsten
COVERAGE	Nej	Ange täckningslager (WCS 1.0.0)
IDENTIFIER	Nej	Ange täckningslager (WCS 1.1.1)
WIDTH	Ja	Bredd på svaret i pixlar
HEIGHT	Ja	Svarets höjd i pixlar
BBOX	Ja	Kartans utbredning i CRS-enheter
CRS	Ja	Koordinatreferenssystem för utbredning
RESPONSE_CRS	Nej	Koordinat referenssystem för svaret

Utöver standardparametrarna har QGIS Server stöd för följande extra parametrar:

Parameter	Obligatorisk	Beskrivning
MAP	Ja	QGIS-projektfil

BBOX

Denna parameter gör det möjligt att ange kartans utbredning i enheterna för det aktuella CRS-systemet. Koordinaterna måste separeras med ett kommatecken. Parametern BBOX är utformad som minx,miny,maxx,maxy.

Exempel på URL:

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

CRS

Denna parameter gör det möjligt att ange det spatiala referenssystemet för parametern BBOX och måste utformas som EPSG:XXXX.

RESPONSE_CRS

Denna parameter gör det möjligt att ange det spatiala referenssystemet för utdata och måste utformas som EPSG:XXXX. CRS för motsvarande täckningslager används som standard.

WIDTH

Denna parameter gör det möjligt att ange bredden i pixlar på utdatabilden. Svarsbildens upplösning beror på detta värde.

HEIGHT

Denna parameter gör det möjligt att ange höjden i pixlar för utdatabilden. Svarsbildens upplösning beror på detta värde.