3.4. 网络覆盖服务(WCS)

这个 1.0.0 和 1.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 IDENTIFIER 和 COVERAGE 都有同样的效果。

备注

IDENTIFIER 在以下情况下是必填的 COVERAGE 未设置。如果两者都有 IDENTIFIER 和 COVERAGE 定义了参数, 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=20 , WIDTH=50&HEIGHT=50 , WIDTH=100&HEIGHT=100