URI
<vectorMap_uri>/v2/datas[.<format>]
支持的方法
父资源
介绍
矢量瓦片服务 V2 中使用数据的列表,包括数据的字段信息以及数据对应的图层信息。当使用 HTML 格式访问时,提供 iClient for MapboxGL with MVT 表述浏览各数据。
支持的方法:
支持的表述格式: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>格式的表述。
请参见