GetCapabilities 操作

发送反馈


GetCapabilities 操作是必需的操作。

GetCapabilities 操作用于获取 WCS 服务级别的元信息及包含数据集合的简要描述。

请求

客户端应发送以 KVP 编码的 Get 请求。

请求参数

GetCapabilities 操作的主要请求参数如下表所示:

表1 GetCapabilities 操作请求主要参数

请求参数 是否必需 描述
SERVICE=WCS

服务类型。

请求 WCS 服务,请求类型需要设为“WCS”。

REQUEST=GetCapabilities

请求名称。

请求 GetCapabilities 操作,请求名称需要设为“GetCapabilities”。

AcceptVersions

请求的 WCS 服务的版本号序列,各个版本间用逗号隔开,并把最希望返回的版本的服务写在最前面。

如果此参数缺省,或者参数值不是服务端支持的版本,则返回服务版本中的最新版本。

Sections

Sections=Contents

请求返回的服务端元信息的部分(Sections),多个部分之间用逗号隔开。

如果此参数缺省,或参数值服务端不支持,则返回当前 WCS 服务的所有信息(Capabilities)。

updateSequence

updateSequence=XXX

服务元信息文档的版本号,因此号码是一个增量,每次修改会增加一个值。

如果此参数缺省,或参数值不是服务端支持的版本号,则返回最新版本的服务元信息。

AcceptFormats

AcceptFormats= text/xml

请求服务描述文档的格式,不同格式用逗号隔开,并把最希望返回的格式放在最前面。

如果此参数缺省,或参数值不是服务端支持的格式,则返回“text/xml”格式。

说明:参数的大小写不是必须的,请求参数的顺序也可以任意顺序排列。

请求示例

GetCapabilities 操作的请求方式如下:

<ServiceRoot>?SERVICE=WCS&REQUEST=GetCapabilities&AcceptVersions=1.1.2

ServiceRoot 为服务的 URI 根目录,请参见 服务的 URI 设置

例如本机 iServer 服务启动后,对 data-world/wcs112 服务执行 GetCapabilities 请求,如下所示:

http://localhost:8090/iserver/services/data-world/wcs112?service=wcs&REQUEST=GetCapabilities

返回的响应结果参见响应示例

响应

服务器端以 XML 文档的格式返回包含客户端所请求的 WCS 服务的简要描述。

响应参数

GetCapabilities 操作返回包含服务级别的元信息及包含数据集合的简要描述的 XML 文档。此文档主要由三个部分组成:

表2 GetCapabilities 操作返回内容

元素名称 描述
ServiceIdentification

服务简介。

ServiceProvider

服务提供者。

即对服务提供者基本信息的描述。

OperationsMetadata

操作元信息。

描述服务所能提供的操作,根据 WCS 标准,三个操作都是必须操作。

Contents

内容目录。

即对当前服务所提供的数据的简单描述。

Contents 部分用于描述当前服务所提供的数据,主要包含以下部分:

表3 Contents 部分的主要内容(全部可选)

元素名称 描述 格式
coverageSummary

对服务提供的最大比例尺的 Coverage 的简单描述。

coverageSummary 格式,见表4.

supportedCRS

GetCoverage 操作支持返回数据的坐标系(CRS)类型。

URI

supportedFormat

GetCoverage 操作支持返回数据的格式。

String

otherSource

指向其他 Contents 元信息

 

其中,coverageSummary 又由以下元素构成:

表4 coverageSummary 部分的主要内容

元素名称 是否必须 描述 是否可继承
(Description)

某 Coverage 的描述

metadata

Coverage 的详细信息。

wgs84BoundingBox

WGS 84 CRS 下十进制经纬度表示的边界框

如未提供,则继承。

supportedCRS

GetCoverage 操作支持返回数据的坐标系(CRS)类型。

supportedFormat

GetCoverage 操作支持返回数据的格式。

Identifier

当前 Coverage 的清晰确认

CoverageSummary

当前 Coverage 的附属 Coverage(子 Coverage)的简单描述

响应示例

请求示例中对 data-world/wcs112 服务执行 GetCapabilities 请求后,服务端返回的 XML 文档如下所示: