vectorStyles

URI

< tileFeature_uri>/vectorstyles[.<format>]

支持的方法

GET、HEAD

父资源

tileFeature

子资源

vectorStyle

介绍

通过对 vectorStyles 资源执行请求，可以获得指定图层的风格信息，如：该图层中点、线、面符号的样式、字体的样式等。风格信息的描述格式支持 CartoCSS 和 Mapbox 标准。执行 GET 请求时，可以指定一个或多个图层，不指定时，将查询到所有图层的风格信息。

支持的方法：

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

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。"World"是地图名。

http://supermapiserver:8090/iserver/services/map-China400/rest/maps/World/tileFeature/vectorstyles.rjson

GET 请求

获取指定图层的风格信息。

请求参数

对 vectorstyles 资源执行 GET 请求，获取地图中指定图层的风格信息，需要在 URI 中包含相关参数，如果没有指定参数，则会默认获得该地图中所有图层的风格信息。参数如下所示：

名称 类型 含义
type VectorStyleType 图层风格的描述语言类型。支持CartoCSS语言和Mapbox_GL。
layerNames String 要查询的图层名称。例如["Countries@World","Lakes@World@@World"]。
tileURLTemplate TileOutputType 发布MVT瓦片为地图服务后，包括发布UGCV5(MVT)和MongoDB中存储的MVT瓦片，tileURLTemplate参数可用。tileURLTemplate用来指定客户端获取 MVT 瓦片的URL模板，包括ZXY、ScaleXY、ViewBounds。详细说明请参考 TileOutputType。

响应结构

返回包含图层名及其风格的信息。

字段 类型 说明
type VectorStyleType 图层风格的描述语言类型。
style String 图层风格信息。包括图层名称及其风格信息。

响应示例

对 vectorStyles 资源请求 China100 地图下 China_provincename_A_txt@China 和 China_SecHydside_pl@China#1 图层的风格信息，使用 CartoCSS 格式描述，则需执行 GET 请求：

http://supermapiserver:8090/iserver/services/map-China400/rest/maps/China/tileFeature/vectorstyles?type=cartoCSS&layerNames=%5B"China_provincename_A_txt@China","China_SecHydside_pl@China#1"%5D。

则返回的 rjson 资源描述如下：

#China_provincename_A_txt@China[zoom<=5.408523429128511E-8][zoom>=2.7042617145642484E-8]{text-placement-type:simple;text-placements:"E,NE,SE,W,NW,SW";line-color:rgba(0,128,0,1);line-width:0.37795275590551186;polygon-fill:rgba(208,255,240,1);marker-width:9.070866141732283;marker-height:9.070866141732283;marker-fill:rgba(13,80,143,1);marker-type:ellipse;polygon-opacity:1.0;polygon-pattern-opacity:1.0;}#China_SecHydside_pl@China\#1[zoom>=8.653637486605571E-7]{text-placement-type:simple;text-placements:"E,NE,SE,W,NW,SW";text-name:"[NAME]";text-placement-type:dummy;text-face-name:"宋体";text-size:11;text-fill:rgba(70,133,208,1);text-opacity:1;text-bold:true;text-italic:true;text-italic-angle:0.0;text-size-fixed:true;text-halo-fill:rgba(255,255,255,1);text-halo:true;text-halo-radius:1;text-vertical-alignment:middle;text-horizontal-alignment:middle;}

 

HEAD 请求

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

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

请参见