tilesets

URI

<map uri>/tilesets[.<format>]

支持的方法

GET、HEAD

父资源

map

子资源

tileset

介绍

切片集列表。不同的切片集，其元信息如切片格式，切片大小，透明等信息不同。通过发送 GET 请求，可以获取某幅地图的所有切片集信息列表。

支持的方法：

GET：获取某幅地图的所有切片集信息列表。
HEAD：检查 tilesets 资源是否存在，或权限是否可以访问 tilesets 资源。

支持的表述格式：（rjson、json、html、xml）。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名，“中国1：400万地图”是地图名（{mapName}），URI 表示的是“中国1：400万地图”的所有切片集信息列表，即

http://supermapiserver:8090/iserver/services/map-world/rest/maps/中国1：400万地图/tilesets.rjson

GET 请求

获取切片集列表。

响应结构

对 tilesets 资源执行 GET 请求，返回的是一个切片集信息列表，其中单个切片集信息的表述的结构如下：

字段	类型	说明
name	String	切片集名称。
metaData	MetaData	地图切片元数据信息。
tileVersions	TileVersion[]	切片版本数组。一个切片集中可以有多个切片版本。

响应示例

对 tilesets 资源：http://supermapiserver:8090/iserver/services/map-world/rest/maps/中国1：400万地图/tilesets.rjson 执行 GET 请求，返回的 rjson 格式的表述如下：

[{
    "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]
        }
    }]
},
{
    "metaData": {
        "bounds": {
            "bottom": -0.4876914572688733,
            "left": 19.62725830088125,
            "leftBottom": {
                "x": 19.62725830088125,
                "y": -0.4876914572688733
            },
            "right": 180,
            "rightTop": {
                "x": 180,
                "y": 81.85192871633846
            },
            "top": 81.85192871633846
        },
        "mapName": "中国1：400万地图",
        "mapStatusHashCode": null,
        "originalPoint": {
            "x": 19.62725830088125,
            "y": 81.85192871633846
        },
        "prjCoordSys": null,
        "resolutions": [0.004753585045132458],
        "scaleDenominators": [2000000],
        "tileFormat": "PNG",
        "tileHeight": 256,
        "tileWidth": 256,
        "transparent": false
    },
    "name": "-1019636791",
    "tileVersions": [{
        "desc": "first version of tileset -1019636791",
        "name": "85a05bf8-7dd6-4daf-8d66-1eeb4ef7a5fd",
        "parent": null,
        "timestamp": 1357787563796,
        "update": {
            "bounds": {
                "bottom": -0.4876914572688733,
                "left": 19.62725830088125,
                "leftBottom": {
                    "x": 19.62725830088125,
                    "y": -0.4876914572688733
                },
                "right": 180,
                "rightTop": {
                    "x": 180,
                    "y": 81.85192871633846
                },
                "top": 81.85192871633846
            },
            "resolutions": [0.004753585045132458],
            "scaleDenominators": [2000000]
        }
    },
    {
        "desc": "",
        "name": "2a1fc765-accd-4f59-b5c0-748b9e39896b",
        "parent": "85a05bf8-7dd6-4daf-8d66-1eeb4ef7a5fd",
        "timestamp": 1358151279984,
        "update": {
            "bounds": {
                "bottom": -0.4876914572688733,
                "left": 19.62725830088125,
                "leftBottom": {
                    "x": 19.62725830088125,
                    "y": -0.4876914572688733
                },
                "right": 180,
                "rightTop": {
                    "x": 180,
                    "y": 81.85192871633846
                },
                "top": 81.85192871633846
            },
            "resolutions": [0.07130377567698698],
            "scaleDenominators": [3.0E7]
        }
    }]
}]

HEAD 请求

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

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