tileVersions


URI

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

Supported methods

GET, HEAD

Parent resource

managerRoot

Introduction

The tile version management resource.

Supported Methods:

Supported output formats: rjson, json, html, xml.

Resource hierarchy

HTTP request methods

Implement the HTTP request on the following URI, where supermapiserver is the server name, with rjson being the output format.

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

GET request

Gets tile version list. Requested parameters must be placed in the URI.

Request parameter

Name Type Description
storeConfigId String [Required]
The tile storage ID.
mapName String [Optional]
The name of the map participating the tiling.
tileFormat String [Required]
The format of generated cache tiles. PNG, JPG , GIF are supported.
tileSize String [Required] The size of the generated cached image. The system provides two types: 256*256 and 512*512.
transparent String [Required]
Whether the background of the generated cache tiles is transparent. The default is false.

Response structure

A tile version list will be returned by implementing the GET request on the tileVersions resource. The representation structure of a single tile version will be as follows:

Field Type Description
desc String The descriptive information of the tile version.
name String The tile version number.
parent String The parent version number, that is, the most update version. Null indicates the current version is the earliest version.
timestamp long The created date of the tile version.
update VersionUpdate The update information of the tile version relative to the parent version.

Response example

The returned rjson format representation after implementing the GET request on the tileVersions resource http://localhost:8090/iserver/manager/tileversions.rjson?storeConfigId=aa&mapName=World&tileFormat=PNG&tileSize=SIZE_256&transparent=false is as follows:

[

    {

        "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.0011883962612831200],

            "scaleDenominators": [500000]

        }

    }

]

HEAD request

Asks for the response identical to the one that would correspond to a GET request, but without the response body. This is useful for retrieving meta-information written in response headers, without having to transport the entire content. The meta-information includes the media-type, content-encoding, transfer-encoding, content-length, etc.

HEAD request can be used to check if the tileVersions resource exists, or if the tileVersions resource can be accessed by clients. It can also determine if the tileVersions resource supports an output format <format> if performed on a URI with .<format> included.

See