tileset


URI

<tilesets uri>/{name}[.<format>]

Supported methods

GET, HEAD

Parent resource

tilesets

Introduction

The tileset resource, including tile metadata, tile name, tile version, etc. The information of a tileset can bet acquired by implementing GET request.

Supported Methods:

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

Resource hierarchy

HTTP request methods

Suppose we implement HTTP request on the following URI and take rjson as the output format. where supermapiserver is the server name, "China1:400Million" is the map name ({mapName}), "-1019636792" is the tileset name ({name}) and URI is the tileset information of "China1:400Million".

http://supermapiserver:8090/iserver/services/map-world/rest/maps/China1:400Million/tilesets/-1019636792.rjson

GET request

Gets the tileset information, including tile metadata, tile name, tile version, etc.

Response structure

The structure of the response resource representation after implementing the GET request on the tileset resource will be as follows:

Field Type Description
name String The tileset name.
metaData MetaData The map tile metadata information.
tileVersions TileVersion[] The tile version array. A tileset can contain multiple tile versions.

Response example

The representation in rjson format returned by implementing the GET request http://supermapiserver:8090/iserver/services/map-world/rest/maps/China1:400Million/tilesets/-1019636792.rjson will be as follows:

{

    "metaData": {

        "bounds": {

            "bottom": -54290.22025579368,

            "left": 2184896.3997221524,

            "leftBottom": {

                "x": 2184896.3997221524,

                "y": -54290.22025579368

            },

            "right": 2.0037508342789244E7,

            "rightTop": {

                "x": 2.0037508342789244E7,

                "y": 1.6850435760215696E7

            },

            "top": 1.6850435760215696E7

        },

        "mapName": "中国1:400万地图",

        "mapStatusHashCode": "-1399916978",

        "originalPoint": {

            "x": 2184896.3997221524,

            "y": 1.6850435760215696E7

        },

        "prjCoordSys": {

            "coordSystem": {

                "datum": {

                    "name": "D_WGS_1984",

                    "spheroid": {

                        "axis": 6378137,

                        "flatten": 0.0033528106647474805,

                        "name": "WGS_1984",

                        "type": "SPHEROID_WGS_1984"

                    },

                    "type": "DATUM_WGS_1984"

                },

                "name": "GCS_WGS_1984",

                "primeMeridian": {

                    "longitudeValue": 0,

                    "name": "Greenwich",

                    "type": "PRIMEMERIDIAN_GREENWICH"

                },

                "spatialRefType": "SPATIALREF_EARTH_LONGITUDE_LATITUDE",

                "type": "GCS_WGS_1984",

                "unit": "DEGREE"

            },

            "coordUnit": "METER",

            "distanceUnit": "METER",

            "epsgCode": 3857,

            "name": "User Define",

            "projection": {

                "name": "SPHERE_MERCATOR",

                "type": "PRJ_SPHERE_MERCATOR"

            },

            "projectionParam": {

                "azimuth": 0,

                "centralMeridian": 0,

                "centralParallel": 0,

                "falseEasting": 0,

                "falseNorthing": 0,

                "firstPointLongitude": 0,

                "firstStandardParallel": 0,

                "scaleFactor": 1,

                "secondPointLongitude": 0,

                "secondStandardParallel": 0

            },

            "type": "PCS_USER_DEFINED"

        },

        "resolutions": null,

        "scaleDenominators": [929665.2461381706],

        "tileFormat": "PNG",

        "tileHeight": 256,

        "tileWidth": 256,

        "transparent": true

    },

    "name": "-1019636792",

    "tileVersions": [{

        "desc": "first version of tileset -1019636792",

        "name": "51de5c76-c994-4207-94a7-d31f948f56e3",

        "parent": null,

        "timestamp": 1358152988765,

        "update": {

            "bounds": {

                "bottom": -54290.22025579368,

                "left": 2184896.3997221524,

                "leftBottom": {

                    "x": 2184896.3997221524,

                    "y": -54290.22025579368

                },

                "right": 2.0037508342789244E7,

                "rightTop": {

                    "x": 2.0037508342789244E7,

                    "y": 1.6850435760215696E7

                },

                "top": 1.6850435760215696E7

            },

            "resolutions": null,

            "scaleDenominators": [929665.2461381706]

        }

    }]

}

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 tileset resource exists, or if the tileset resource can be accessed by clients. It can also determine if the tileset resource supports an output format <format> if performed on a URI with .<format> included.

See