GetCapabilities Request |
Main request parameters of the GetCapabilities operation are shown in the following table:
Table 1 Main parameters of the GetCapabilities operation request
| Request Parameters | O/M /Optional | Description |
| VERSION=version |
O |
Request version. If the server does not support the requested version, it will return a different version according to OGC standards. Values are in the form of x.y.y, where x is any nonnegative integer and y is an integer within the range of [0-99]. |
| SERVICE=WMS |
R |
Service type. When invoking GetCapabilities on a WMS that implements this version of the specification or a later one, the service_name value "WMS" shall be used. |
| REQUEST=GetCapabilities |
R |
Request name. When requesting the GetCapabilities operation, the request name should be set as "GetCapabilities" or "capabilities" (capabilities is of the version 1.0.0 and not recommended. The aim of supporting this value is backward compatibility). |
| UPDATESEQUENCE=string |
O |
Sequence number or string for cache control This parameter can guarantee the consistency of the cache. This parameter value can be an integer, a timestamp string conforming to the format of ISO 8601:2004, or any other string. If the server contains the UpdateSequence value in the Capbilities XML document, then the UpdateSequence value should increase progressively when the Capabilities changes (for example, when adding new maps to the service). SuperMap iServer has not realized this functionality at present. |
Note: The case of parameters is not mandatory, and request parameters can be arranged in an arbitrary order.
For the UPDATESEQUENCE parameter, if the client contains this parameter in the GetCapabilities request parameters, then the server will respond based on the UPDATESEQUENCE value of the server metadata and the UPDATESEQUENCE request value on the client, as shown in the following table:
Table 2 Use of UpdateSequence Parameter
| Client Request UpdateSequence Value | Server Metadata UpdateSequence Value | Server Response |
| none | any | most recent Capabilities XML |
| any | none | most recent Capabilities XML |
| equal | equal |
Exception: code=CurrentUpdateSequence |
| lower | higher | most recent Capabilities XML |
| higher | lower |
Exception: code=InvalidUpdateSequence |
Request methods of the GetCapabilities operation are as follows:
<ServiceRoot>?SERVICE=WMS&VERSION=version&REQUEST=GetCapabilities
ServiceRoot is the service URI root directory. Please see Setting the Service URI.
For example, after the local SuperMap iServer 6R WMS 1.1.1 service is started successfully, the URI of accessing the GetCapabilities operation is:http://localhost:8090/iserver/services/map-world/wms111/WorldMap_Day?SERVICE=WMS&VERSION=1.1.1&REQUEST=GetCapabilities.
For response results of this request example usage, please seeResponse example.