<managerRoot uri>/tileversions[.<format>]
切片版本管理资源。
支持的方法:
支持的表述格式:(rjson、json、html、xml)。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/manager/tileversions.rjson
获取切片版本列表。请求参数必须放在 URI 中。
名称 | 类型 | 含义 |
storeConfigId | String | 【必选参数】 切片存储 ID。 |
mapName | String | 【必选参数】 参与切图的地图名称。 |
tileFormat | String | 【必选参数】 生成的缓存图片的格式,支持 PNG、JPG 、GIF 格式。 |
tileSize | String | 【必选参数】 生成的缓存图片的大小,系统提供了256*256、512*512两种类型。 |
transparent | String | 【必选参数】 生成的缓存图片的背景是否透明,默认为 false。 |
对 tileVersions 资源执行 GET 请求,返回切片版本列表信息,其中单个切片版本信息的表述结构如下:
字段 | 类型 | 说明 |
desc | String | 切片版本的描述信息。 |
name | String | 切片版本号。 |
parent | String | 父版本号,即最后一个更新版本。如果为空,表示当前版本是初始版本。 |
timestamp | long | 切片版本创建的时间。 |
update | VersionUpdate | 切片版本更新信息。指的是相对于父版本基础上的更新信息。 |
对 tileVersions 资源:http://localhost:8090/iserver/manager/tileversions.rjson?storeConfigId=aa&mapName=World&tileFormat=PNG&tileSize=SIZE_256&transparent=false 执行 GET 请求,返回的 rjson 格式的表述结构如下:
[
{
"desc": "first version of tileset 1596041633",
"name": "d2faef88-896e-4809-8b18-1cb3b8018866",
"parent": null,
"timestamp": 1355885636462,
"update": {
"bounds": {
"bottom": -90,
"left": -180,
"leftBottom": {
"x": -180,
"y": -90
},
"right": 180,
"rightTop": {
"x": 180,
"y": 90
},
"top": 90
},
"resolutions": [0.004753585045132467],
"scaleDenominators": [2000000]
}
},
{
"desc": "",
"name": "a93d9072-937e-4584-9a1c-b566112920cb",
"parent": "d2faef88-896e-4809-8b18-1cb3b8018866",
"timestamp": 1355886044715,
"update": {
"bounds": {
"bottom": -90,
"left": -180,
"leftBottom": {
"x": -180,
"y": -90
},
"right": 180,
"rightTop": {
"x": 180,
"y": 90
},
"top": 90
},
"resolutions": [0.004753585045132467],
"scaleDenominators": [2000000]
}
},
{
"desc": "",
"name": "0842cd2f-8cff-4332-ac15-49e8791f2606",
"parent": "a93d9072-937e-4584-9a1c-b566112920cb",
"timestamp": 1358749232132,
"update": {
"bounds": {
"bottom": -90,
"left": -180,
"leftBottom": {
"x": -180,
"y": -90
},
"right": 180,
"rightTop": {
"x": 180,
"y": 90
},
"top": 90
},
"resolutions": [0.0011883962612831167],
"scaleDenominators": [500000]
}
}
]
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 tileVersions 资源是否存在,或者客户端是否有权限访问 tileVersions 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 tileVersions 资源是否支持<format>格式的表述。