tileVersions


URI

<managerRoot uri>/tileversions[.<format>]

支持的方法

GETHEAD

父资源

managerRoot

介绍

切片版本管理资源。

支持的方法:

支持的表述格式:(rjson、json、html、xml)。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/manager/tileversions.rjson

GET 请求

获取切片版本列表。请求参数必须放在 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]

        }

    }

]

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。

HEAD 请求可以用来判断 tileVersions 资源是否存在,或者客户端是否有权限访问 tileVersions 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 tileVersions 资源是否支持<format>格式的表述。

请参见