请求参数
GetCapabilities 操作的 URL 请求参数如下表所示：
表1 GetCapabilities 操作请求主要参数
|
请求参数 |
是否必需 |
描述 |
| VERSION=version |
否 |
请求版本号。 |
| SERVICE=WMS |
是 |
服务类型。 请求 WMS 服务，请求类型需要设为“WMS”。 |
| REQUEST=GetCapabilities |
是 |
请求名称。 请求 GetCapabilities 操作，请求名称需要设为“GetCapabilities”。 |
| FORMAT=MIME_type |
否 |
服务元数据的输出格式。 对于一个 GetCapabilities 请求，WMS 服务器支持在服务元数据中有一个或多个<Request><GetCapabilities><Format>元素值。 服务器支持默认的 text/xml 格式，对其他的支持是可选的。 FORMAT 参数需要设置为完整的 MIME 类型字符串。在 HTTP 环境中，需要在 HTTP 响应头 Content-type 中设置 MIME 类型。如果请求指定了一个服务器不支持的格式，服务器将返回默认的 text/xml 格式。 |
| UPDATESEQUENCE=string |
否 |
用于缓存控制的序列号或字符串。 该参数可以保证缓存的一致性。 该参数的值可以是一个整数，符合 ISO 8601:2004格式的时间戳字符串，或者其他任意字符串。 服务器如果在元数据中包含 UpdateSequence 值，那么当 Capabilities 发生变化时（比如，当有新的地图加到服务中时），UpdateSequence 的值应该是递增的。 SuperMap iServer 目前还没有实现该功能。 |
对于 UPDATESEQUENCE 参数，如果客户端在 GetCapabilities 请求参数中包含了该参数，那么服务器将基于服务器元数据的 UPDATESEQUENCE 值和客户端的 UPDATESEQUENCE 请求值进行响应，如下表：
表2 UPDATESEQUENCE 参数的使用
|
客户端请求的 UPDATESEQUENCE 值 |
服务器元数据 UPDATESEQUENCE 值 |
服务器响应 |
|
none |
any |
最接近的服务元数据 |
|
any |
none |
最接近的服务元数据 |
|
equal |
equal |
异常： code=CurrentUpdateSequence |
|
lower |
higher |
最接近的服务元数据 |
|
higher |
lower |
异常： code=InvalidUpdateSequence |
请求示例
GetCapabilities 操作的请求方式如下：
<ServiceRoot>?SERVICE=WMS&VERSION=version&REQUEST=GetCapabilities
ServiceRoot 为服务的 URI 根目录，请参见 服务的 URI 设置。
例如，本机 SuperMap iServer WMS 1.3.0 服务启动成功之后，访问 GetCapabilities 操作的 URI 是：http://localhost:8090/iserver/services/map-world/wms130/世界地图_Day?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities。
该请求示例的响应结果请参见 响应示例。