URI

<vectorMap_uri>/v2/mapserver/serverInfo/{serverName}[.<format>]

支持的方法

GET、HEAD

父资源

vectorMap

介绍

提供矢量瓦片服务 V2 中栅格出图有关服务的信息，如瓦片原点、地图范围、比例尺、缓存等信息。

该接口可覆盖JW矢量瓦片服务相应能力。

支持的方法：

  • GET：获取矢量瓦片服务 V2 中栅格出图有关服务的信息。
  • HEAD：检查 serverInfo 资源是否存在，权限是否可以访问。

支持的表述格式：RJSON、JSON、JSONP。

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 json 输出格式为例加以说明，其中，supermapiserver 是服务器名，{component}是服务组件名 ，{serverName}是服务发布时定义的“服务名称”（若未设置，则为 iServer 根据规则生成的默认服务名）。

http://supermapiserver:8090/iserver/services/{component}/restjsr/v2/mapserver/serverInfo/{serverName}.json

GET 请求

获取矢量瓦片服务 V2 中栅格出图有关服务的信息，包括瓦片原点、地图范围、比例尺、使用的数据及过滤条件等。

响应结构

对 serverInfo 资源执行 GET 请求，返回的资源表述的结构如下：  

字段 类型 说明
id string 服务标识 ID，示例值 word
serviceType string 服务类型，固定为 vector_service（矢量服务）
vectorCachedLevels string 存在的矢量缓存层级，逗号分隔数字。
imageCachedLevels object 存在的栅格缓存层级，以样式为单位。key 为样式 ID，键为缓存文件夹中存在的栅格缓存层级，其值为 string 类型，逗号分隔数字。
例如：{"DLTB": { "P_256_1431900458": "4,6,7,8,9,10"}
layerMap object 图层配置映射集合，key 为图层 ID
dataSetMap object 数据集配置映射集合，key 为数据集 ID
gridTreeName string 瓦片网格树名称，示例 tdt_degree_base512
gridType string 瓦片网格类型
gridUnit string 网格单位
gridBase string 瓦片基础规格，base512（512 像素瓦片）
grid object 瓦片网格详细配置
version string 服务版本号（时间戳格式）
origin array[] 瓦片原点坐标
srid number 空间参考坐标系 EPSG 编码，例如 4326
resolutions array[] 各级瓦片分辨率，即比例尺信息
cacheLayerMap object 缓存图层映射，空对象代表无缓存配置
bbox string 服务全局地理范围，以“,”分割

layerMap 的响应结构

字段 类型 说明
idFieldType string 要素 ID 字段数据类型
layerType string 图层类型，固定为 VECTOR（矢量图层）
idField string 要素唯一标识字段名
beginLevel number 图层起始显示层级
labelOnly boolean 是否仅标注模式，false 为矢量 + 标注
levelMap object 各缩放层级配置映射，key 为层级号
endLevel number 图层结束显示层级
haveLabel boolean 是否开启标注，false 未开启
id string 图层 ID
fields array[] 图层属性字段集合
cutOutScreen boolean 是否开启屏幕裁切，true 开启
geometryType string 要素几何类型

layerMap-levelMap 的响应结构

字段 类型 说明
filterSQL string 层级要素过滤 SQL 语句，空代表不过滤
virtual boolean 是否虚拟层级，false 为真实瓦片层级
dataSetId string 绑定的数据集 ID
level int 当前瓦片层级号
simplifyForLayerLevel int 层级要素简化系数，0 为不简化

layerMap-fields 的响应结构

字段 类型 说明
id boolean 是否为主键 ID 字段，true 是主键
index int 字段索引序号
name string 字段英文名称
type string 字段数据类型

datasetMap 的响应结构

字段 类型 说明
filter string 数据集全局过滤条件，空代表不过滤
dataServiceId string 绑定的数据服务唯一 ID
bbox string 数据集对应的地理范围
id string 数据集 ID

grid 的响应结构

字段 类型 说明
maxLevel number 瓦片最大层级
base number 瓦片基础像素，512
unit string 网格单位
resolutionLevelBegin number 比例尺起始层级
minX number 网格最小经度
minY number 网格最小纬度
maxX number 网格最大经度
maxY number 网格最大纬度
beginLevel number 网格生效起始层级
type string 瓦片类型
name string 网格名称
resolutions array[] 各比例尺层级瓦片分辨率数组

响应示例

对 serverInfo 资源：http://supermapiserver:8090/iserver/services/vectorMap-DLTB-public/restjsr/v2/mapserver/serverInfo/DLTB.json 执行 GET 请求，返回 json 格式的资源表述如下：

{
  "serviceType": "vector_service",

  "imageCachedLevels": {
    "DLTB": {
      "P_256_1431900458": "4,5"
    },
  "vectorCachedLevels": "4,5,6,7",
  "origin": [
    -180,
    90
  ],
  "bbox": "109.41607750300243,22.617793848072214,110.47650761500358,23.48064438917779",
  "resolutions": [
    0.703125,
    0.3515625,
    0.17578125,
    0.087890625,
    0.0439453125,
    0.02197265625,
    0.010986328125,
    0.0054931640625,
    0.00274658203125,
    0.001373291015625,
    0.0006866455078125,
    0.00034332275390625,
    0.000171661376953125,
    0.0000858306884765625,
    0.00004291534423828125,
    0.000021457672119140625,
    0.000010728836059570312,
    0.000005364418029785156,
    0.000002682209014892578,
    0.000001341104507446289,
    6.705522537231445e-7,
    3.3527612686157227e-7,
    1.6763806343078613e-7,
    8.381903171539307e-8,
    4.190951585769653e-8,
    2.0954757928848267e-8
  ],
  "version": null,
  "gridTreeName": "tdt_degree_base512",
  "dataSetMap": {
    "dltb40w_4326": {
      "filter": null,
      "dataServiceId": null,
      "bbox": "109.41607750300243,22.617793848072214,110.47650761500358,23.48064438917779",
      "id": "dltb40w_4326"
    }
  },
  "srid": 4326,
  "layerMap": {
    "dltb40w_4326": {
      "idFieldType": "integer",
      "idField": "smid",
      "layerType": "VECTOR",
      "beginLevel": 1,
      "labelOnly": false,
      "haveLabel": false,
      "levelMap": {
        "1": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 1,
          "simplifyForLayerLevel": 0
        },
        "2": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 2,
          "simplifyForLayerLevel": 0
        },
        "3": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 3,
          "simplifyForLayerLevel": 0
        },
        "4": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 4,
          "simplifyForLayerLevel": 0
        },
        "5": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 5,
          "simplifyForLayerLevel": 0
        },
        "6": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 6,
          "simplifyForLayerLevel": 0
        },
        "7": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 7,
          "simplifyForLayerLevel": 0
        },
        "8": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 8,
          "simplifyForLayerLevel": 0
        },
        "9": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 9,
          "simplifyForLayerLevel": 0
        },
        "10": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 10,
          "simplifyForLayerLevel": 0
        },
        "11": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 11,
          "simplifyForLayerLevel": 0
        },
        "12": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 12,
          "simplifyForLayerLevel": 0
        },
        "13": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 13,
          "simplifyForLayerLevel": 0
        },
        "14": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 14,
          "simplifyForLayerLevel": 0
        },
        "15": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 15,
          "simplifyForLayerLevel": 0
        },
        "16": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 16,
          "simplifyForLayerLevel": 0
        },
        "17": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 17,
          "simplifyForLayerLevel": 0
        },
        "18": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 18,
          "simplifyForLayerLevel": 0
        },
        "19": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 19,
          "simplifyForLayerLevel": 0
        },
        "20": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 20,
          "simplifyForLayerLevel": 0
        },
        "21": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 21,
          "simplifyForLayerLevel": 0
        },
        "22": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 22,
          "simplifyForLayerLevel": 0
        },
        "23": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 23,
          "simplifyForLayerLevel": 0
        },
        "24": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 24,
          "simplifyForLayerLevel": 0
        },
        "25": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 25,
          "simplifyForLayerLevel": 0
        },
        "26": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 26,
          "simplifyForLayerLevel": 0
        },
        "27": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 27,
          "simplifyForLayerLevel": 0
        },
        "28": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 28,
          "simplifyForLayerLevel": 0
        },
        "29": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 29,
          "simplifyForLayerLevel": 0
        },
        "30": {
          "filterSQL": "",
          "virtual": false,
          "dataSetId": "dltb40w_4326",
          "level": 30,
          "simplifyForLayerLevel": 0
        }
      },
      "id": "dltb40w_4326",
      "fields": [
        {
          "name": "SmID",
          "index": 0,
          "id": false,
          "type": "integer"
        },
        {
          "name": "smuserid",
          "index": 0,
          "id": false,
          "type": "integer"
        },
        {
          "name": "smarea",
          "index": 0,
          "id": false,
          "type": "double"
        },
        {
          "name": "smperimeter",
          "index": 0,
          "id": false,
          "type": "double"
        },
        {
          "name": "smgeometry",
          "index": 0,
          "id": false,
          "type": "bytes"
        },
        {
          "name": "smgeoparam",
          "index": 0,
          "id": false,
          "type": "bytes"
        },
        {
          "name": "tbbh",
          "index": 0,
          "id": false,
          "type": "string"
        },
        {
          "name": "dlbm",
          "index": 0,
          "id": false,
          "type": "string"
        },
        {
          "name": "dlmc",
          "index": 0,
          "id": false,
          "type": "string"
        },
        {
          "name": "gdlx",
          "index": 0,
          "id": false,
          "type": "string"
        },
        {
          "name": "dlbz",
          "index": 0,
          "id": false,
          "type": "string"
        },
        {
          "name": "gdpdj",
          "index": 0,
          "id": false,
          "type": "string"
        },
        {
          "name": "xzdwmj",
          "index": 0,
          "id": false,
          "type": "double"
        }
      ],
      "cutOutScreen": true,
      "endLevel": 30,
      "geometryType": "MULTIPOLYGON"
    }
  },
  "gridType": "tdt",
  "grid": {
    "maxLevel": 30,
    "unit": "degree",
    "beginLevel": 2,
    "minY": -90,
    "minX": -180,
    "maxY": 90,
    "maxX": 180,
    "name": "degree512esri",
    "resolutions": [
      0.703125,
      0.3515625,
      0.17578125,
      0.087890625,
      0.0439453125,
      0.02197265625,
      0.010986328125,
      0.0054931640625,
      0.00274658203125,
      0.001373291015625,
      0.0006866455078125,
      0.00034332275390625,
      0.000171661376953125,
      0.0000858306884765625,
      0.00004291534423828125,
      0.000021457672119140625,
      0.000010728836059570312,
      0.000005364418029785156,
      0.000002682209014892578,
      0.000001341104507446289,
      6.705522537231445e-7,
      3.3527612686157227e-7,
      1.6763806343078613e-7,
      8.381903171539307e-8,
      4.190951585769653e-8,
      2.0954757928848267e-8,
      1.0477378964424133e-8,
      5.238689482212067e-9,
      2.6193447411060333e-9,
      1.3096723705530167e-9,
      0
    ],
    "resolutionLevelBegin": 0,
    "type": "esri",
    "base": 512
  },
  "id": "DLTB",
  "cacheLayerMap": null,
  "gridBase": "base512",
  "gridUnit": "degree"
}

HEAD 请求

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

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

请参见