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 文档如下所示：

<?xml version="1.0" encoding="UTF-8"?> <Capabilities xmlns="http://www.opengis.net/wcs/1.1" xmlns:ows="http://www.opengis.net/ows/1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:gml="http://www.opengis.net/gml" xsi:schemaLocation="http://www.opengis.net/wcs/1.1 http://localhost:8090/iserver/services/data-world/wcs112?request=getschema&file=wcs,1.1.2,wcsGetCapabilities.xsd" version="1.1.2"> <ows:ServiceIdentification> <ows:Title>示例 WCS 服务</ows:Title> <ows:Abstract>SuperMap iServer 基于示范数据发布的 WCS 服务</ows:Abstract> <ows:Keywords> <ows:Keyword>iServer</ows:Keyword> <ows:Keyword>Sample Data</ows:Keyword> </ows:Keywords> <ows:ServiceType>WCS</ows:ServiceType> <ows:ServiceTypeVersion>1.1.1</ows:ServiceTypeVersion> <ows:ServiceTypeVersion>1.1.2</ows:ServiceTypeVersion> <ows:Fees>none</ows:Fees> <ows:AccessConstraints>none</ows:AccessConstraints> </ows:ServiceIdentification> <ows:ServiceProvider> <ows:ProviderName>北京超图软件股份有限公司</ows:ProviderName> <ows:ProviderSite xlink:href="https://www.supermap.com.cn" /> <ows:ServiceContact> <ows:IndividualName>联系人姓名</ows:IndividualName> <ows:PositionName>联系人职位</ows:PositionName> <ows:ContactInfo> <ows:Phone> <ows:Voice>+86-10-59896655</ows:Voice> <ows:Facsimile>+86-10-59896666</ows:Facsimile> </ows:Phone> <ows:Address> <ows:DeliveryPoint>北京市朝阳区酒仙桥北路甲10号院电子城 IT 产业园107号楼6层北京超图软件股份有限公司</ows:DeliveryPoint> <ows:City>北京</ows:City> <ows:AdministrativeArea>北京</ows:AdministrativeArea> <ows:PostalCode>100015</ows:PostalCode> <ows:Country>中国</ows:Country> <ows:ElectronicMailAddress>support@supermap.com</ows:ElectronicMailAddress> </ows:Address> </ows:ContactInfo> </ows:ServiceContact> </ows:ServiceProvider> <ows:OperationsMetadata> <ows:Operation name="GetCapabilities"> <ows:DCP> <ows:HTTP> <ows:Get xlink:href="http://localhost:8090/iserver/services/data-world/wcs112?"> </ows:Get> <ows:Post xlink:href="http://localhost:8090/iserver/services/data-world/wcs112?"> </ows:Post> </ows:HTTP> </ows:DCP> </ows:Operation> <ows:Operation name="DescribeCoverage"> <ows:DCP> <ows:HTTP> <ows:Get xlink:href="http://localhost:8090/iserver/services/data-world/wcs112?"> </ows:Get> <ows:Post xlink:href="http://localhost:8090/iserver/services/data-world/wcs112?"> </ows:Post> </ows:HTTP> </ows:DCP> </ows:Operation> <ows:Operation name="GetCoverage"> <ows:DCP> <ows:HTTP> <ows:Get xlink:href="http://localhost:8090/iserver/services/data-world/wcs112?"> </ows:Get> <ows:Post xlink:href="http://localhost:8090/iserver/services/data-world/wcs112?"> </ows:Post> </ows:HTTP> </ows:DCP> <ows:Parameter name="store"> <ows:AllowedValues> <ows:Value>True</ows:Value> <ows:Value>False</ows:Value> </ows:AllowedValues> </ows:Parameter> </ows:Operation> </ows:OperationsMetadata> <Contents> <CoverageSummary> <ows:Title>Day</ows:Title> <ows:Abstract></ows:Abstract> <ows:WGS84BoundingBox> <ows:LowerCorner>-180.0 -89.99999999999997</ows:LowerCorner> <ows:UpperCorner>180.0 89.99999999999997</ows:UpperCorner> </ows:WGS84BoundingBox> <Identifier>1</Identifier> </CoverageSummary> <CoverageSummary> <ows:Title>Night</ows:Title> <ows:Abstract></ows:Abstract> <ows:WGS84BoundingBox> <ows:LowerCorner>-180.0 -89.99999999999997</ows:LowerCorner> <ows:UpperCorner>180.0 89.99999999999997</ows:UpperCorner> </ows:WGS84BoundingBox> <Identifier>2</Identifier> </CoverageSummary> </Contents> </Capabilities>