tileFeature

URI

<dataset_uri>/tilefeature[.<format>]

支持的方法

父资源

介绍

通过对 tileFeature 资源执行请求，可以获取地图中矢量图层{layerName}中的瓦片要素。客户端获取的瓦片要素，可以通过自定义的样式进行渲染，并可查询交互。

您可以在 URI 中设置输出矢量切片的参数，如设置图层、切片大小、格网行列号等。其中，格网的划分规则如下：将地图全幅显示时的图片从左上角开始，往下和往右进行切割，切割的大小默认为256*256 像素，左上角的格网行号为 0，列号为 0，往下和往右依次递增。其中，格网的大小和地图的比例尺等参数都可以在请求时进行指定。

支持的方法：

GET：获取地图中指定矢量图层的瓦片要素，URI 中的参数确定了格网的位置。
HEAD：检查 tileFeature 资源是否存在，或权限是否可以访问 tileFeature 资源。

支持的表述格式：RJSON、JSON、HTML、XML、FASTJSON、MVT、JSONP。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名，“China_Nation_B_pt”是图层名（{layerName}）。

http://supermapiserver:8090/iserver/services/data-China100/rest/data/datasources/China/datasets/China_Nation_B_pt/tilefeature.rjson

GET 请求

获取地图的矢量切片，URI 中的参数确定了格网的位置等信息。

请求参数

对 tileFeature 资源执行 GET 请求，获取地图中指定矢量图层的瓦片要素，需要在 URI 中包含相关参数，如果没有指定参数，则会按照地图的当前状态为准，进行切割和出图。参数如下所示：

名称	类型	含义
x	long	格网在地图中列号，从左向右递增。默认情况下，切片从地图最左上角开始，其格网列号为0。
y	long	格网在地图中行号，从上向下递增。默认情况下，切片从地图最左上角开始，其格网行号为0。
scale	double	地图的比例尺。如0.0001表示比例尺为1：10000。详见比例尺的定义。
width	int	格网的宽度，单位是像素，默认为 256 像素。
height	int	格网的高度，单位是像素，默认为 256 像素。
compressTolerance	int	抽稀容限。单位为像素，合并容限范围内的坐标序列。
cacheEnabled	boolean	是否使用缓存，默认为 false。
Attributes	boolean	是否返回属性，默认为 false。
ViewBounds	String	根据 ViewBounds 的范围获取对应的瓦片，如: viewBounds=1.2914800299064118E7,4931105.5687329285,1.299307181602814E7,5009377.085696951
returnFields	String	返回 returnField 中指定的字段，可设置多个字段，各字段间用英文 ',' 隔开。如: returnFields=Name,PAC

响应结构

返回包含矢量图层名和要素坐标的数据信息。

字段	类型	说明
recordsets	VectorRecordSet[]	记录集。每条记录由 fetures（要素集）和 layer（图层名）组成。

响应示例

对 tileFeature 资源请求 " China100" 下“China_Nation_B_pt”的矢量切片，则需执行 GET 请求：http://localhost:8090/iserver/services/data-China100/rest/data/datasources/China/datasets/China_Nation_B_pt/tilefeature.rjson?scale=0.000000027043&x=0&y=0&width=256&height=256&compressTolerance=&returnAttributes=false&cacheEnabled=false

则返回的 rjson 如下：

{ "recordsets": [{ "features": [ { "searchValues": null, "geometry": { "parts": [1], "coordinateType": null, "type": "POINT", "cutEdges": null, "partTopo": null, "points": [ 0, 1 ] }, "attributes": null, "id": 1 }, { "searchValues": null, "geometry": { "parts": [1], "coordinateType": null, "type": "POINT", "cutEdges": null, "partTopo": null, "points": [ 55, 1 ] }, "attributes": null, "id": 2 }, { "searchValues": null, "geometry": { "parts": [1], "coordinateType": null, "type": "POINT", "cutEdges": null, "partTopo": null, "points": [ 112, 0 ] }, "attributes": null, "id": 3 }, { "searchValues": null, "geometry": { "parts": [1], "coordinateType": null, "type": "POINT", "cutEdges": null, "partTopo": null, "points": [ 167, 0 ] }, "attributes": null, "id": 4 }, { "searchValues": null, "geometry": { "parts": [1], "coordinateType": null, "type": "POINT", "cutEdges": null, "partTopo": null, "points": [ 220, 0 ] }, "attributes": null, "id": 7 } ], "fieldTypes": [ "INT32", "DOUBLE", "DOUBLE", "INT32", "INT32", "INT32", "INT64", "INT32", "TEXT" ], "layerName": "China_Nation_B_pt@China", "fields": [ "SmID", "SmX", "SmY", "SmLibTileID", "SmUserID", "SmGeometrySize", "SmGeoPosition", "ID", "NAME" ] }], "tileData": null }

HEAD 请求

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

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