queryable

URI

<layer_uri>/queryable[.<format>]

支持的方法

GET、HEAD

父资源

layer

介绍

作为 layer 的一个子资源，queryable 资源用于标识该图层是否可查询，通过对 queryable 资源执行 PUT 请求，还可以改变该图层的可查询状态。

支持的方法：

GET：获取图层是否可查询的表述。
HEAD：检查 queryable 资源是否存在，或权限是否可以访问 queryable 资源。

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

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名，“世界地图”是地图名（{mapName}），Capitals@world 是地图“世界地图” 中的一个图层（{layerName}），Capitals@world@@世界地图表示它是 World 图层的一个子图层，URI 表示 Capitals@world 图层的 queryable 资源。

http://supermapiserver:8090/iserver/services/map-world/rest/maps/世界地图/layers/Capitals@World@@世界地图/queryable.rjson

GET 请求

获取该图层是否可见的描述，返回 true 表示可见，false 表示不可见。

请求参数

名称	类型	含义
_cache	boolean	【可选参数】是否使用缓存，默认为 true。如果为 false，则关闭所有缓存。

响应结构

对 queryable 资源执行 GET 请求，返回一个布尔值，表示图层是否可查询，true 表示可查询。

响应示例

对如下 queryable 资源：http://supermapiserver:8090/iserver/services/map-world/rest/maps/世界地图/layers/Capitals@World@@世界地图/queryable.rjson 执行 GET 请求，返回 Capitals@world 图层是否可查询的信息如下：

true

HEAD 请求

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

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