visible


URI

<tempLayer_uri>/visible[.<format>]

支持的方法

GETPUTHEAD

父资源

tempLayer

介绍

作为 tempLayer 的一个子资源,visible 资源用于标识该临时图层是否可见,通过对 visible 资源执行 PUT 请求,还可以改变该图层的可见性。

支持的方法:

支持的表述格式:RJSON、JSON、HTML、XML。

资源层次

根资源 maps 资源 map 资源 tempLayersSet 资源 tempLayers 资源 tempLayers 资源 visible 资源

HTTP 请求方法

对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名,"世界地图"是地图名({mapName}),1是"世界地图" 中的一个临时图层集({tempLayersID}),URI 表示的是"世界地图"中的 ID 是1的临时图层集合,即 tempLayers 资源,Capitals@world 是临时图层集中 World 图层的一个子图层,URI 表示临时图层 Capitals@world 的 visible 资源。

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

GET 请求

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

请求参数

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

响应结构

对 visible 资源执行 GET 请求,返回一个布尔值,表示图层是否可见,true 表示可见。

响应示例

对 visible 资源:http://supermapiserver:8090/iserver/services/map-world/rest/maps/世界地图/tempLayersSet/1/Capitals@World@@世界地图/visible.rjson 执行 GET 请求,返回 Capitals@world 图层是否可见的信息如下:

true

PUT 请求

修改临时图层的可见性。

请求参数

为执行 PUT 请求来修改图层的可见性,PUT 请求体中必须包含一些参数,如果参数合法,iServer 服务器会根据这些参数对图层的可见性进行修改。

这里参数为一个布尔值,表示图层是否可见,true 表示可见。

响应结构

对 visible 资源执行 PUT 请求,返回的操作结果表述的结构如下(表述在响应消息的实体主体里):

字段 类型 说明
succeed boolean

修改临时图层可见性是否成功。如果不成功会有错误信息。

error HttpError 出错信息,如果修改成功,则没有本字段。

响应示例

对如下 visible 资源:http://supermapiserver:8090/iserver/services/map-world/rest/maps/世界地图/tempLayersSet/1/Capitals@World@@世界地图/visible.rjson,执行 PUT 请求,请求体如下:

false

修改 Capitals@world 图层为不可见,修改成功时,返回 rjson 格式的操作结果表述如下:

{

    "succeed": true

}

HEAD 请求

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

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

请参见