GetCapabilities 响应

发送反馈


在调用 WMS 服务的时候,对于 GetCapabilities 请求,WMS 将返回一个包含服务元数据格式的响应,并且该响应基于 WMS Capabilities XML schema。

响应说明

WMS Capabilities XML 主要包含 ServiceCapability 两个组成部分。

Service

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

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

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

服务标题。

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

Abstract

服务摘要。

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

OnlineResource

在线资源。

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

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

KeywordList|Keyword

关键字。

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

ContactInformation

联系信息。

应该包含该元素。

LayerLimit

图层限制个数。

该元素值是一个正整数,表示允许客户端在单个 GetMap 请求 中能够请求的最大图层个数。

如果该元素不存在,则服务器默认为没有限制。

MaxWidth & MaxHeight

最大宽度和高度。

这两个元素的值是正整数,表示运行客户端在单个 GetMap 请求中能够请求的图片的最大宽度和高度。

如果任意一个值没有,服务器将默认为没有限制。

Fees

费用。

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

如果使用了该元素,“none”(不区分大小写)表示免费,比如“<Fees>none</Fees>”。

AccessConstraints

访问限制。

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

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

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

Capability

<Capability>元素中的内容表达了服务器支持所支持的请求(GetCapabilities、GetMap 或 GetFeatureInfo),每一种操作的输出格式,以及每一个操作的 URL 前缀。XML schema 包含了不止 HTTP 一种分布式平台(Distributed Computing Platforms,DCP),但目前只定义了 HTTP 平台。

此外,<Capability>元素中还指明了异常格式,图层等信息。

WMS 服务元数据中,大部分都是图层的信息。WMS 服务器提供的地理信息内容都组织在图层中。

图层属性(Layer properties)

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

表2 图层属性

元素名称 是否必须 描述
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。

EX_GeographicBoundingBox

地理边界框。

每一个命名的图层将包含一个<EX_GeographicBoundingBox>元素,表示图层覆盖的最小边界矩形区域,以十进制的度数表示。EX_GeographicBoundingBox 有利于在没有坐标转换时的地理搜索。

该元素通过 westBoundLongitude、eastBoundLongitude、southBoundLatitude 和 northBoundLatitude 组成。

EX_GeographicBoundingBox 可以继承自父图层。

我们目前使用的是 EPSG:4326。

CRS

坐标参考系统(Coordinate Reference System)。

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

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

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

BoundingBox

边界框。

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

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

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

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

BoundingBox 可以继承自服务图层。

MinScaleDenominator & MaxScaleDenominator

最小最大比例尺倒数。

用于表示比例尺范围。

如果两个元素同时不存在,表示没有比例尺限制。

Dimension

适用于多维数据。

Dimension 继承自父图层。

MetadataURL

元数据 URL。

一个服务器应该使用1个或多个<MetadataURL>提供图层数据详细和标准的元数据。

不能被子图层继承。

Attribution

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

  • <OnlineResource>表示数据提供者的 URL。
  • <Title>是数据提供者的名称。
  • <LogoURL>是 Logo 图片的 URL。

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

Identifier & AuthorityURL

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

FeatureListURL

要素 URL 列表。

DataURL

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

DataURL 不能被子图层继承。

Layer 元素属性(attributes)

表3 Layer 元素属性

属性 允许的值 含义(默认值为0)
queryable 0,false,1,true

0,false:图层不可查。

1,true:图层可查。

cascaded 0,正整数

0:图层还没有被层叠 Map 服务器(Cascading Map Server)转发。

n:图层已经被转发 n 次。

opaque 0,false,1,true

0,false:地图数据不是完全不透明。

1,true:地图数据完全不透明。

noSubsets 0,false,1,true

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

1,true:WMS 只绘制完整边界框。

fixedWidth 0,正整数

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

非0:地图的宽度固定,WMS 不能修改。

fixedHeight 0,正整数

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

非0:地图的高度固定,WMS 不能修改。

响应示例

请求示例 的响应结果如下: