tileFeature

URI

<dataset_uri>/tilefeature[.<format>]

支持的方法

父资源

介绍

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

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

支持的方法：

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

支持的表述格式：MVT、RJSON（已过时）、JSON（已过时）、HTML（已过时）、XML（已过时）、FASTJSON（已过时）、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、Y），二是按照视图范围获取（参数为 ViewBounds ），其他参数相同，具体如下所示：

名称	类型	含义
x	long	格网在地图中列号，从左向右递增。默认情况下，切片从地图最左上角开始，其格网列号为0。
y	long	格网在地图中行号，从上向下递增。默认情况下，切片从地图最左上角开始，其格网行号为0。
z	long	地图显示层级，如 10。注：1. 当该参数和 scale 同时存在时，scale 参数生效。2. 该参数不可与 origin 参数一同使用。
ViewBounds	String	根据 ViewBounds 的范围获取对应的瓦片，如: viewBounds=1.2914800299064118E7,4931105.5687329285,1.299307181602814E7,5009377.085696951
scale	double	地图的比例尺。如0.0001表示比例尺为1：10000。详见比例尺的定义。
width	int	格网的宽度，单位是像素，默认为 256 像素。
height	int	格网的高度，单位是像素，默认为 256 像素。
origin	Point2D	切片的起始参考点，默认为数据范围的左上角。如果指定为其他值，则以所赋值作为切片的起始参考点，计算切片行列号。
compressTolerance （已过时）	int	抽稀容限。单位为像素，合并容限范围内的坐标序列。注：mvt格式暂不支持设置。
cacheEnabled	boolean	是否使用缓存，默认为 false。
Attributes	boolean	是否返回属性，默认为 false。
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>格式的表述。