GetCapabilities 响应

发送反馈

响应说明

 

在与 OGC 标准一致的 WMS 的特别情形中，根据 DTD（XML 文件类型定义，XML Document Type Definition ），XML 响应必须是合法的。DTD 表明了响应中必需和可选的内容，以及内容格式的形成。

服务器的 Capabilities XML 文档完全参考了 DTD 文档，而不是 URL 的主体部分。DTD 文件必须定位在完全合格并且可用的 URL 中，以便允许 XML 验证软件来检索它。

WMS Capabilities XML 主要包含 Service 和 Capability 两个组成部分。

Service

WMS Capabilities XML 中的<Service>元素中的内容表示通用服务元数据（General service metadata），该元素提供了对服务器通用元数据的一个整体描述。该数据包括 Name、Title 以及 Online Resource URL 元素，另外包括一些可选的内容：Abstract、KeywordList、ContactInformation、Fees 和 AccessConstraints 元素等。

表1 通用服务元数据的元素

元素名称 描述
Name WMS 服务的名称。
Title

服务标题。

服务器的简短描述，取决于服务提供者，能够跟其它服务器相区分。
Abstract

服务摘要。

提供有关服务器信息的更多描述。
KeywordList

关键字。

服务器作为一个整体，能够有助于目录搜索。
OnlineResource

在线资源。

提供服务提供者的网站参考。

其他 OnlineResource 元素是每个操作的 URL 前缀。
ContactInformation

联系信息，包括了服务提供者名称、地址、电话、传真、邮箱等信息。

服务元数据中应该包含该元素。
Fees

费用。

如果服务器没有应用费用，该元素可以忽略。

如果使用了该元素，“none”（不区分大小写）表示免费，比如“<Fees>none</Fees>”。
AccessConstraints

访问限制。

如果服务器没有应用访问限制，该元素可以忽略。

如果使用了该元素，“none”（不区分大小写）表示没有访问限制，比如“<AccessConstraints>none</AccessConstraints>”。

如果使用该元素，该元素的内容没有准确的语法定义，客户端可显示用户信息和行为内容。

 

Capability

<Capability>元素中的内容表达了服务器实例所支持的请求（GetCapabilities、GetMap 或 GetFeatureInfo），每一种操作提供的输出格式，以及每一个操作的 URL 前缀。XML DTD 包括了分布式平台（Distributed Computing Platforms，DCP）的占位符，以及其它的 HTTP 请求方法。但目前只定义了 HTTP GET 作为基本的 WMS 操作。

可忽略的服务提供者特定元素可以包含在 <Capability> 元素中。 WMS 中还会包含 <UserDefinedSymbolization> 元素以及 HTTP POST 请求的 URL。 

Layer 和 Style 是 WMS Capabilities XML 文档中最重要的部分。

每个可用的地图都通过 <Layer> 元素列举在 Capabilities XML 文档中。一个父图层可以包含任意数目的子图层。

地图服务器必须在每个提供的地图中至少包含一个 <Layer> 元素。

<Style> 节点提供图层的风格列表，STYLES 通过 SLD（Styled-Layer Descriptor，图层样式表）定义，在 Capabilities XML 文档中列出的 STYLES 是服务器预定义的样式。

目前 Layer/Style 的 Name，Title 和 Keywords 是可选的。

图层属性（Layer properties）

<Layer>元素的嵌套子元素，表达了图层的属性信息。

表2 图层属性（Layer properties）

元素 是否必需

描述
Title

是

图层标题。每个图层必须有一个标题。

不能被子图层继承。
Name

否

图层名称。

如果图层有 <Name> 元素，那么在 GetMap 请求 中可以使用 Name 作为 LAYERS 参数的值。

客户端不会请求一个只有 Title 而没有 Name 的图层。

如果客户端请求了一个非法的图层，WMS 服务器将抛出服务异常（code="LayerNotDefined"）。

Name 不能被子图层继承。
Abstract

否

图层摘要。

提供有关图层的更加详细的描述。

Abstract 不能被子图层继承。
KeywordList

否

关键字列表。

KeywordList 包含0个或多个 <Keyword> 元素有助于目录搜索。

KeywordList 不能被子图层继承。
Style

否

图层风格。

0个或多个<Style>用来表示单个图层或者图层集合的风格。每一个 Style 包含<Name>和<Title>元素。Name 用于设置 GetMap 请求中的 STYLES 参数。

Style 还可能包含其它一些元素。<Abstract>提供了风格的描述，<LegendURL>包含了地图图例的图片位置。

LegendURL 中的<Format>元素表示图例图片的 MIME 类型，<Format>元素的 width 和 height 属性表示图片的像素大小。

Style 可以被子图层继承，如果子图层的 Name 和父图层一样，则子图层将不会重新定义 Style。
SRS

是

坐标参考系统（Spatical Reference System）。

每一个图层有一个或多个 SRS。SRS 可以被子图层继承。根元素 <Layer> 包含0个或多个 SRS 元素，列举了通用于所有子图层的 SRS。

对空间参考系统的支持情况参见iServer OGC 服务支持发布的坐标参考系。
LatLonBoundingBox

否

经纬度边界框。

每个图层必须包含至少一个 <LatLonBoundingBox> 元素，可以声明，也可以从父图层继承而来。

LatLonBoundingBox 声明了地图数据在 EPSG:4326坐标系统下的最小外接矩形。其属性 minx, miny, maxx, maxy 以十进制的度数表示了矩形的边界。

LatLonBoundingBox 有利于在不要求坐标转换时的地理搜索。
BoundingBox

是

边界框。

一个图层包含1个或多个边界框。

< BoundingBox>元素包含以下属性：

  • SRS，表明应用于边界框的图层 SRS。
  • minx, miny, maxx, maxy，表明边界框的大小。
  • resx 和 resy（可选），表示空间分辨率。

BoundingBox 元数据指明了图层的坐标范围，请求参数 BBOX，指明了地图的区域。BBOX 区域和 BoundingBox 区域不一定要相交，包含或被包含。

BoundingBox 可以继承自父图层。
ScaleHint

否

<ScaleHint> 元素给出了能恰当的显示图层的最小和最大比例尺。

ScaleHint 有两个值：minimum 和 maximum

ScaleHint 可以被子图层继承。在子图层中定义的 ScaleHint 会覆盖继承自父图层的定义。
Dimension

否

用于多维数据。

Dimension 的定义可以继承自父图层。子图层中任何一个新的 Dimension 定义都可以增加到继承父图层的列表中。子图层不能重新定义继承父图层的同名的 Dimension 元素。
Extent

否

用于多维数据。

Extent 的定义可以继承自父图层。子图层中继承自父图层的同名的 Extent  的声明会覆盖父图层中声明的值。只有当 Capabilities XML 文档中已经声明或者继承了同名的 Dimension ，Layer 才会声明一个 Extent。
MetadataURL

否

元数据 URL。

一个服务器应该使用1个或多个<MetadataURL>来提供图层数据详细和标准的元数据。目前定义了两种类型：'TC211' 参照 [ISO 19115]；'FGDC' 参照 [FGDC-STD-001-1988].

MetadataURL 元素不能在非标准化元数据格式中作为参考，包含在其中的 <Formmat> 元素表明了元数据记录的 MIME 类型的文件格式。

此元素不能被子图层继承。
Attribution

否

该元素用于定义图层或图层集合的地理信息来源。

<OnlineResource> 表示数据提供者的 URL。

<Title> 是数据提供者的名称。

<LogoURL> 是 Logo 图片的 URL。

<Format>表明了 Logto 图片的 MIME 类型。

<width> 和 <height> 属性指定了图像的像素大小。

该元素可以被子图层继承。
Identifier and AuthorityURL

否

 WMS 服务器可以使用0个或多个 <Identifier> 列举 Authority 定义的 ID 号或者标签。
FeatureListURL

否

要素 URL 列表。

用来指向一个图层上的要素列表。

FeatureListURL 不可以被子图层继承。
DataURL

否

DataURL 提供了一个被特定图层描述的数据的链接。

DataURL 不能被子图层继承。
CRS

是

坐标参考系统（Coordinate Reference System）。

每一个图层有一个或多个 CRS。

CRS 可以被子图层继承。根<Layer>元素包含0个或多个 CRS 元素，列举了通用于所有子图层的 CRS。

对空间参考系统的支持情况参见iServer OGC 服务支持发布的坐标参考系。

图层元素属性（Layer Attributes）

<Layer> 元素可以有零个或者多个下表中的 XML 属性：queryable，cascaded，opaque，noSubsets， fixedWidth，fixedHeight。这些属性都是可选的。每个属性都可以被继承或者被子图层替代。

表3 图层元素属性（Layer Attributes）

属性 允许的值 含义（默认值为0）
queryable 0， 1

0：图层不可查。

1：图层可查。
cascaded 0，正整数

0：图层还没有被层叠 Map 服务器（Cascading Map Server）转发。

n：图层已经被转发 n 次。
opaque 0， 1

0：地图数据不是完全不透明。

1：地图数据完全不透明。
noSubsets 0， 1

0：WMS 可以绘制一个完整边界框的子集。

1：WMS 只绘制完整边界框。
fixedWidth 0，正整数

0：WMS 可以生成一个任意宽度的地图。

非0：地图的宽度固定，WMS 不能修改。
fixedHeight 0，正整数

0：WMS 可以生成一个任意高度的地图。

非0：地图的高度固定，WMS 不能修改。

响应示例

GetCapabilities 操作返回的数据 MIME 类型为 application/vnd.ogc.wms_xml，本质是 xml 文档。

GetCapabilities 请求示例的响应内容示例如下：