pickup

URI

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

支持的方法

GET、HEAD

父资源

vectorMap

介绍

该资源用于查询指定样式中指定地图层级、指定点位置所属的要素，其返回地图中所有符合条件图层中要素的字段及属性值。

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

支持的方法：

GET：查询指定样式中指定地图层级、指定点位置所属的要素。
HEAD：检查 datas 资源是否存在，权限是否可以访问。

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

HTTP 请求方法

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

http://supermapiserver:8090/iserver/services/vectorMap-DLTB-public/restjsr/v2/mapserver/{serverName}/{styleId}/pickup.json

GET 请求

查询指定样式中指定地图层级、指定点位置所属的要素，返回地图中所有符合条件图层中要素的字段及属性值。

请求参数

名称	类型	含义
level	int	【必选参数】地图层级
lon	double	【必选参数】点选查询时点的经度。
lat	double	【必选参数】点选查询时点的纬度。
includelabel	boolean	是否包含注记，默认为false

响应结构

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

字段	类型	说明
layer	json 对象	使用layerID代指图层，表达指定图层中包含的指定要素，要素为一个对象，由要素ID代指，其中包含的字段为所有要素属性

响应示例

对 pickup 资源：http://supermapiserver:8090/iserver/services/vectorMap-DLTB-public/restjsr/v2/mapserver/test/DLTB/pickup.json?level=14&lon=108.32708358764648&lat=23.329034821872966&includelabel=false 执行 GET 请求，返回 json 格式的资源表述如下：

{
"dltb40w_4490": {
"6755903": {
"smid": 6755903,
"dlbm": "113",
"dlmc": "水库水面"
}
}
}

HEAD 请求

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

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

URI