3.4. 网络覆盖服务(WCS)

这个 1.0.01.1.1 QGIS Server中实施的WCS标准提供了访问栅格数据的HTTP接口,称为 coverage ,来自于一个QGIS项目。

规格:

QGIS服务器提供的标准请求:

请求

描述

GetCapabilities

返回包含有关服务器的信息的XML元数据

DescribeCoverage

检索有关Coverage的其他信息的XML文档

GetCoverage

检索覆盖率

3.4.1. GetCapabilities

的标准参数 GetCapabilities 根据OGC WCS 1.1.1规范提出的请求:

参数

必填项

描述

SERVICE

服务的名称( WCS )

REQUEST

请求的名称( GetCapabilities )

VERSION

不是

服务的版本

除了标准参数外,QGIS Server还支持以下额外参数:

参数

必填项

描述

MAP

QGIS工程文件

URL示例:

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

单个栅格图层(名为 T20QPD_20171123T144719_TCI )发布在WCS服务的QGIS项目中:

<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

此参数允许指定要使用的服务版本。目前,版本值不在内部使用,并且始终回退到 1.1.1

3.4.2. DescribeCoverage

此请求允许检索有关Coverage的附加信息,如基础数据源的格式、波段数量等。的标准参数 DescribeCoverage 根据OGC WCS 1.1.1规范提出的请求:

参数

必填项

描述

SERVICE

服务的名称( WCS )

REQUEST

请求的名称( DescribeCoverage )

VERSION

不是

服务的版本

COVERAGE

不是

指定Coverage图层(WCS 1.0.0)

IDENTIFIER

不是

指定Coverage图层(WCS 1.1.1)

除了标准参数外,QGIS Server还支持以下额外参数:

参数

必填项

描述

MAP

QGIS工程文件

3波段GeoTIFF栅格图层的XML文档如下所示:

<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

此参数在WCS中定义 1.0.0 允许指定要查询其他信息的层。姓名必须用逗号分隔。

此外,QGIS Server还引入了一个按其短名称选择层的选项。可通过以下方式配置图层的简称 Properties ► Metadata 在层菜单中。如果定义了短名称,则默认情况下将使用它而不是层的名称:

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

备注

COVERAGE 在以下情况下是必填的 IDENTIFIER 未设置。

IDENTIFIER

此参数将替换 COVERAGE WCS中的参数 1.1.1 。但QGIS服务器不会根据 VERSION 参数SO IDENTIFIERCOVERAGE 都有同样的效果。

备注

IDENTIFIER 在以下情况下是必填的 COVERAGE 未设置。如果两者都有 IDENTIFIERCOVERAGE 定义了参数, COVERAGE 始终优先使用。

3.4.3. GetCoverage

此请求允许根据特定约束(如范围或CRS)检索覆盖范围。的标准参数 DescribeCoverage 根据OGC WCS 1.1.1规范提出的请求:

参数

必填项

描述

SERVICE

服务的名称( WCS )

REQUEST

请求的名称( GetCoverage )

VERSION

不是

服务的版本

COVERAGE

不是

指定Coverage图层(WCS 1.0.0)

IDENTIFIER

不是

指定Coverage图层(WCS 1.1.1)

WIDTH

响应的宽度(以像素为单位

HEIGHT

以像素为单位的响应高度

BBOX

使用CRS单位绘制地图范围

CRS

范围的坐标参考系

RESPONSE_CRS

不是

响应的坐标参考系

除了标准参数外,QGIS Server还支持以下额外参数:

参数

必填项

描述

MAP

QGIS工程文件

BBOX

此参数允许以当前CRS为单位指定地图范围。坐标必须用逗号分隔。这个 BBOX 参数的格式如下所示 minx,miny,maxx,maxy

URL示例:

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

CRS

此参数用于指示的空间参考系 BBOX 参数,并且必须采用如下形式 EPSG:XXXX

RESPONSE_CRS

此参数用于指示输出响应空间参考系,其格式如下 EPSG:XXXX 。默认使用对应覆盖层的CRS。

WIDTH

此参数允许以像素为单位指定输出图像的宽度。响应图像的分辨率取决于此值。

HEIGHT

此参数允许以像素为单位指定输出图像的高度。响应图像的分辨率取决于此值。

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

图 3.22 从左到右: WIDTH=20&HEIGHT=20WIDTH=50&HEIGHT=50WIDTH=100&HEIGHT=100