URI

<vectorMap_uri>/v2/datas[.<format>]

支持的方法

GETHEAD

父资源

vectorMap

介绍

矢量瓦片服务 V2 中使用数据的列表,包括数据的字段信息以及数据对应的图层信息。当使用 HTML 格式访问时,提供 iClient for MapboxGL with MVT 表述浏览各数据。

支持的方法:

  • GET:获取矢量瓦片服务 V2 中使用的数据及其对应的图层信息。
  • HEAD:检查 datas 资源是否存在,权限是否可以访问。

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

HTTP 请求方法

对如下 URI 执行 HTTP 请求,以 json 输出格式为例加以说明,其中,supermapiserver 是服务器名,{component}是服务组件名 ,{serverName}是服务发布时定义的“服务名称”。

http://supermapiserver:8090/iserver/services/vectorMap-DLTB-public/restjsr/v2/datas.json

GET 请求

获取矢量瓦片服务 V2 中使用数据的列表及其信息,包括数据的字段信息以及数据对应的图层信息等。

响应结构

对 datas 资源执行 GET 请求,返回的资源表述的结构如下:  

字段 类型 说明
idField string 图层要素唯一标识字段名
database string 数据所属数据库名称
beginLevel int 图层起始显示缩放层级
bounds Rectangle2D 图层可见地理范围
dataName string 数据集名称
hasLabel null/boolean 是否开启注记图层
id string 图层唯一 ID
isVisible boolean 图层默认是否可见,false 为默认隐藏
fields array[] 图层属性字段配置集合
endLevel number 图层终止显示缩放层级
geometryType string 要素几何类型
labelField string 注记使用的字段名

fields 的响应结构

字段 类型 说明
isRequired boolean 字段是否必选
defaultValue string 字段默认值
name string 字段名称
caption string 字段显示别名
type string 字段数据类型
maxLength int 字段最大长度,-1 表示无限制
isZeroLengthAllowed boolean 是否允许空字符串
isSystemField boolean 是否为系统内置字段(如smid、smarea 等)

响应示例

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

[
  {
    "idField": "smid",
    "database": "DLTB",
    "beginLevel": 1,
    "bounds": {
      "top": 23.48064438917779,
      "left": 109.41607750300243,
      "bottom": 22.617793848072214,
      "leftBottom": {
        "x": 109.41607750300243,
        "y": 22.617793848072214,
        "m": null
      },
      "right": 110.47650761500358,
      "rightTop": {
        "x": 110.47650761500358,
        "y": 23.48064438917779,
        "m": null
      }
    },
    "dataName": "dltb40w_4326",
    "hasLabel": null,
    "id": null,
    "isVisible": false,
    "fields": [
      {
        "isRequired": true,
        "defaultValue": "nextval('dltb40w_4326_smid_seq'::regclass)",
        "name": "SmID",
        "caption": "SmID",
        "type": "INT32",
        "maxLength": 4,
        "isZeroLengthAllowed": false,
        "isSystemField": true
      },
      {
        "isRequired": true,
        "defaultValue": "0",
        "name": "smuserid",
        "caption": "smuserid",
        "type": "INT32",
        "maxLength": 4,
        "isZeroLengthAllowed": false,
        "isSystemField": false
      },
      {
        "isRequired": true,
        "defaultValue": "0.0",
        "name": "smarea",
        "caption": "smarea",
        "type": "DOUBLE",
        "maxLength": 8,
        "isZeroLengthAllowed": false,
        "isSystemField": true
      },
      {
        "isRequired": true,
        "defaultValue": "0.0",
        "name": "smperimeter",
        "caption": "smperimeter",
        "type": "DOUBLE",
        "maxLength": 8,
        "isZeroLengthAllowed": false,
        "isSystemField": true
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "smgeometry",
        "caption": "smgeometry",
        "type": "LONGBINARY",
        "maxLength": -1,
        "isZeroLengthAllowed": false,
        "isSystemField": true
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "smgeoparam",
        "caption": "smgeoparam",
        "type": "LONGBINARY",
        "maxLength": -1,
        "isZeroLengthAllowed": false,
        "isSystemField": true
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "bsm",
        "caption": "bsm",
        "type": "INT32",
        "maxLength": 4,
        "isZeroLengthAllowed": false,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "ysdm",
        "caption": "ysdm",
        "type": "WTEXT",
        "maxLength": 10,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "tbybh",
        "caption": "tbybh",
        "type": "WTEXT",
        "maxLength": 8,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "tbbh",
        "caption": "tbbh",
        "type": "WTEXT",
        "maxLength": 8,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "dlbm",
        "caption": "dlbm",
        "type": "WTEXT",
        "maxLength": 4,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "dlmc",
        "caption": "dlmc",
        "type": "WTEXT",
        "maxLength": 60,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "qsxz",
        "caption": "qsxz",
        "type": "WTEXT",
        "maxLength": 3,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "qsdwdm",
        "caption": "qsdwdm",
        "type": "WTEXT",
        "maxLength": 19,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "qsdwmc",
        "caption": "qsdwmc",
        "type": "WTEXT",
        "maxLength": 60,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "zldwdm",
        "caption": "zldwdm",
        "type": "WTEXT",
        "maxLength": 19,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "zldwmc",
        "caption": "zldwmc",
        "type": "WTEXT",
        "maxLength": 60,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "gdlx",
        "caption": "gdlx",
        "type": "WTEXT",
        "maxLength": 2,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "kclx",
        "caption": "kclx",
        "type": "WTEXT",
        "maxLength": 2,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "dlbz",
        "caption": "dlbz",
        "type": "WTEXT",
        "maxLength": 2,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "gdpdj",
        "caption": "gdpdj",
        "type": "WTEXT",
        "maxLength": 2,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "kcdlbm",
        "caption": "kcdlbm",
        "type": "WTEXT",
        "maxLength": 4,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "tkxs",
        "caption": "tkxs",
        "type": "DOUBLE",
        "maxLength": 8,
        "isZeroLengthAllowed": false,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "tbmj",
        "caption": "tbmj",
        "type": "DOUBLE",
        "maxLength": 8,
        "isZeroLengthAllowed": false,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "xzdwmj",
        "caption": "xzdwmj",
        "type": "DOUBLE",
        "maxLength": 8,
        "isZeroLengthAllowed": false,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "lxdwmj",
        "caption": "lxdwmj",
        "type": "DOUBLE",
        "maxLength": 8,
        "isZeroLengthAllowed": false,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "tkmj",
        "caption": "tkmj",
        "type": "DOUBLE",
        "maxLength": 8,
        "isZeroLengthAllowed": false,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "tbdlmj",
        "caption": "tbdlmj",
        "type": "DOUBLE",
        "maxLength": 8,
        "isZeroLengthAllowed": false,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "pzwh",
        "caption": "pzwh",
        "type": "WTEXT",
        "maxLength": 50,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "bgjlh",
        "caption": "bgjlh",
        "type": "WTEXT",
        "maxLength": 20,
        "isZeroLengthAllowed": true,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "bgrq",
        "caption": "bgrq",
        "type": "DATETIME",
        "maxLength": 8,
        "isZeroLengthAllowed": false,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "shape_leng",
        "caption": "shape_leng",
        "type": "DOUBLE",
        "maxLength": 8,
        "isZeroLengthAllowed": false,
        "isSystemField": false
      },
      {
        "isRequired": false,
        "defaultValue": "",
        "name": "shape_area",
        "caption": "shape_area",
        "type": "DOUBLE",
        "maxLength": 8,
        "isZeroLengthAllowed": false,
        "isSystemField": false
      }
    ],
    "endLevel": 24,
    "geometryType": "REGION",
    "labelField": null
  }
]

HEAD 请求

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

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

请参见