style


URI

<layer_uri>/style[.<format>]

支持的方法

GETHEAD

父资源

layer

介绍

作为 layer 的一个子资源,style 资源用于图层的样式。只有 SuperMap 矢量图层(UGCVectorLayer)允许设置风格,其余类型的图层不允许设置风格。

支持的方法:

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

资源层次

resources.htm maps.htm map.htm layer.htm layers.htm style.htm

HTTP 请求方法

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

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

GET 请求

获取图层的样式。

请求参数

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

响应结构

对 style 资源执行 GET 请求,当图层为 SuperMap 矢量图层(UGCVectorLayer)时,支持风格设置,返回资源表述的结构如下(资源表述在响应消息的实体主体里):   

字段 类型 说明
markerSymbolID int 点状符号的编码,即符号库中点风格的 ID。
markerSize double 点状符号的大小。
markerAngle double 点状符号的旋转角度。
lineWidth double 边线宽度。
lineSymbolID int 线状符号的编码,即线型库中线型的 ID。
lineColor Color 符号为线状符号时,表示边线的颜色;符号为点状符号时,表示点的颜色。
fillSymbolID int 填充符号的编码,即在填充库中填充风格的 ID。
fillOpaqueRate int 填充不透明度,合法值为 0——100 的数值。
fillGradientOffsetRatioX double 渐变填充中心点相对于填充区域范围中心点的水平偏移百分比。
fillGradientOffsetRatioY double 填充中心点相对于填充区域范围中心点的垂直偏移百分比。
fillGradientMode FillGradientMode 渐变填充风格的渐变类型。
fillGradientAngle double 渐变填充的旋转角度。
fillForeColor Color 填充符号的前景色。
fillBackOpaque boolean 当前填充背景是否不透明。
fillBackColor Color 填充符号的背景色。

当图层为 SuperMap 矢量图层(UGCVectorLayer)时,不支持风格设置,返回的资源表述的结构如下:

字段 类型 说明
succeed boolean

false,表示图层不支持风格设置。

error HttpError 出错信息。

 

响应示例

对如下 style 资源:http://supermapiserver:8090/iserver/services/map-world/rest/maps/世界地图/layers/Capitals@World@@世界地图/style.rjson,执行 GET 请求,获取 Capitals@world 图层的样式如下:

{

    "fillBackColor": {

        "blue": 255,

        "green": 255,

        "red": 255

    },

    "fillBackOpaque": true,

    "fillForeColor": {

        "blue": 196,

        "green": 196,

        "red": 196

    },

    "fillGradientAngle": 0,

    "fillGradientMode": "NONE",

    "fillGradientOffsetRatioX": 0,

    "fillGradientOffsetRatioY": 0,

    "fillOpaqueRate": 100,

    "fillSymbolID": 0,

    "lineColor": {

        "blue": 0,

        "green": 0,

        "red": 0

    },

    "lineSymbolID": 0,

    "lineWidth": 0.1,

    "markerAngle": 0,

    "markerSize": 2,

    "markerSymbolID": 12

}

 

HEAD 请求

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

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

请参见