URI

<map_uri>/style[.<format>]

支持的方法

GET、HEAD

父资源

map

介绍

对style资源执行GET请求，可获取当前地图的Mapbox标准风格信息。详细介绍可参见Mapbox官网（http://www.mapbox.com/mapbox-gl-js/style-spec）。

支持的方法：

• GET：获取当前地图的风格信息。
• HEAD：检查 style 资源是否存在，或权限是否可以访问 style 资源。

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

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/services/map-world/restjsr/v1/vectortile/maps/World/style.json

GET 请求

获取当前地图的风格信息。

请求参数

对 style 资源执行 GET 请求，需要在 URI 中包含相关参数，参数如下所示：

名称	类型	含义
returnTileAttributes	Boolean	是否返回属性信息，默认为true。
excludeBackgroundLayer	Boolean	【2026 Update1版本新增】当返回的图层风格为 MapBox_GL 类型时，是否排除 type 为 background 的图层，默认为 false，即不排除。仅当设置为 true 时，图层风格将排除 background 图层，从而在渲染矢量瓦片时，不渲染背景图层。
prjCoordSys	JSON	【2026 Update1版本新增】目标投影坐标系，JSON 格式如 {"epsgCode":4326}。指定时返回的样式按目标投影生成，且响应体中 tiles 字段将自动嵌入该参数；不传则使用地图默认投影。

响应示例

对style资源执行GET请求：http://supermapiserver:8090/iserver/services/map-world/restjsr/v1/vectortile/maps/World/style.json，则返回的结果如下：

{"metadata":{"mapcenter":[0,0],"indexbounds":[-180,-270,180,90],"mapscale":5.912160537196359E-9,"epsgcode":0,"topscale":3.38032714320531E-9,"mapbounds":[-180,-90,180,90]},"sources":{"World":{"tiles":["http://localhost:8090/iserver/services/test/restjsr/v1/vectortile/maps/World/tiles/{z}/{x}/{y}.mvt"],"bounds":[-180,-90,180,90],"type":"vector"}},"center":[0,0],"name":"World","sprite":"http://localhost:8090/iserver/services/test/restjsr/v1/vectortile/maps/World/sprites/sprite","layers":[{"paint":{"background-color":"rgba(179,209,255,1.00)"},"id":"background","type":"background"},{"layout":{"visibility":"visible"},"metadata":{"layer:caption":"OceanL@World"},"maxzoom":21,"paint":{"line-width":3.78,"line-color":"rgba(179,209,255,1.00)"},"id":"OceanL@World","source":"World","source-layer":"OceanL@World","type":"line","minzoom":1},{"layout":{"visibility":"visible"},"metadata":{"layer:caption":"Countries@World"},"maxzoom":21,"paint":{"line-width":0.38,"line-color":"rgba(167,170,164,1.00)"},"id":"Countries@World_outline","source":"World","source-layer":"Countries@World","type":"line","minzoom":1},{"layout":{"visibility":"visible"},"filter":["all",["==","$type","Polygon"],["==","ColorID",1]],"metadata":{"layer:caption":"Countries@World#2"},"maxzoom":21,"paint":{"fill-color":"rgba(199,207,247,1.00)","fill-antialias":true},"id":"Countries@World#2_1","source":"World","source-layer":"Countries@World#2","type":"fill","minzoom":0},{"layout":{"visibility":"visible"},"filter":["all",["==","$type","Polygon"],["==","ColorID",1]],"metadata":{"layer:caption":"Countries@World#2"},"maxzoom":21,"paint":{"line-width":0.38,"line-color":"rgba(199,207,247,1.00)"},"id":"Countries@World#2_1_outline","source":"World","source-layer":"Countries@World#2","type":"line","minzoom":0},{"layout":{"visibility":"visible"},"filter":["all",["==","$type","Polygon"],["==","ColorID",2]],"metadata":{"layer:caption":"Countries@World#2"},"maxzoom":21,"paint":{"fill-color":"rgba(193,227,201,1.00)","fill-antialias":true},"id":"Countries@World#2_2","source":"World","source-layer":"Countries@World#2","type":"fill","minzoom":0},{"layout":{"visibility":"visible"},"filter":["all",["==","$type","Polygon"],["==","ColorID",2]],"metadata":{"layer:caption":"Countries@World#2"},"maxzoom":21,"paint":{"line-width":0.38,"line-color":"rgba(193,227,201,1.00)"},"id":"Countries@World#2_2_outline","source":"World","source-layer":"Countries@World#2","type":"line","minzoom":0},{"layout":{"visibility":"visible"},"filter":["all",["==","$type","Polygon"],["==","ColorID",3]],"metadata":{"layer:caption":"Countries@World#2"},"maxzoom":21,"paint":{"fill-color":"rgba(247,209,197,1.00)","fill-antialias":true},"id":"Countries@World#2_3","source":"World","source-layer":"Countries@World#2","type":"fill","minzoom":0},{"layout":{"visibility":"visible"},"filter":["all",["==","$type","Polygon"],["==","ColorID",3]],"metadata":{"layer:caption":"Countries@World#2"},"maxzoom":21,"paint":{"line-width":0.38,"line-color":"rgba(247,209,197,1.00)"},"id":"Countries@World#2_3_outline","source":"World","source-layer":"Countries@World#2","type":"line","minzoom":0},{"layout":{"visibility":"visible"},"filter":["all",["==","$type","Polygon"],["==","ColorID",4]],"metadata":{"layer:caption":"Countries@World#2"},"maxzoom":21,"paint":{"fill-color":"rgba(247,231,197,1.00)","fill-antialias":true},"id":"Countries@World#2_4","source":"World","source-layer":"Countries@World#2","type":"fill","minzoom":0},{"layout":{"visibility":"visible"},"filter":["all",["==","$type","Polygon"],["==","ColorID",4]],"metadata":{"layer:caption":"Countries@World#2"},"maxzoom":21,"paint":{"line-width":0.38,"line-color":"rgba(247,231,197,1.00)"},"id":"Countries@World#2_4_outline","source":"World","source-layer":"Countries@World#2","type":"line","minzoom":0},{"layout":{"visibility":"visible"},"metadata":{"layer:caption":"Lakes@World"},"maxzoom":21,"paint":{"fill-color":"rgba(179,209,255,1.00)","fill-antialias":true},"id":"Lakes@World","source":"World","source-layer":"Lakes@World","type":"fill","minzoom":1},{"layout":{"visibility":"visible"},"metadata":{"layer:caption":"Lakes@World"},"maxzoom":21,"paint":{"line-width":0.38,"line-color":"rgba(179,209,255,1.00)"},"id":"Lakes@World_outline","source":"World","source-layer":"Lakes@World","type":"line","minzoom":1},{"layout":{"visibility":"visible"},"metadata":{"layer:caption":"China_island_part@World"},"maxzoom":21,"paint":{"fill-color":"rgba(238,236,225,1.00)","fill-antialias":true},"id":"China_island_part@World","source":"World","source-layer":"China_island_part@World","type":"fill","minzoom":0},{"layout":{"visibility":"visible"},"metadata":{"layer:caption":"Rivers@World"},"maxzoom":21,"paint":{"line-width":0.38,"line-color":"rgba(179,209,255,1.00)"},"id":"Rivers@World","source":"World","source-layer":"Rivers@World","type":"line","minzoom":2},{"layout":{"visibility":"visible"},"metadata":{"layer:caption":"Country_Label@World"},"maxzoom":21,"paint":{"line-width":0.38,"line-color":"rgba(191,191,191,1.00)"},"id":"Country_Label@World","source":"World","source-layer":"Country_Label@World","type":"line","minzoom":0},{"layout":{"visibility":"visible"},"metadata":{"layer:caption":"China_Boundary_1@World"},"maxzoom":21,"paint":{"line-width":0.38,"line-dasharray":[2.5,2],"line-color":"rgba(191,191,191,1.00)"},"id":"China_Boundary_1@World","source":"World","source-layer":"China_Boundary_1@World","type":"line","minzoom":0},{"layout":{"visibility":"visible"},"metadata":{"layer:caption":"China_Boundary_nanhai@World"},"maxzoom":21,"paint":{"line-width":1.51,"line-color":"rgba(191,191,191,1.00)"},"id":"China_Boundary_nanhai@World","source":"World","source-layer":"China_Boundary_nanhai@World","type":"line","minzoom":0},{"layout":{"text-rotate":360,"visibility":"visible","text-letter-spacing":0,"text-justify":"left","text-field":"{COUNTRY}","text-rotation-alignment":"viewport","text-size":13.22,"text-anchor":"center","text-allow-overlap":false,"text-ignore-placement":false,"symbol-placement":"point","text-font":["Microsoft YaHei Regular"]},"filter":["all",["has","COUNTRY"],["!=","COUNTRY",""]],"metadata":{"layer:caption":"Countries@World#1"},"maxzoom":21,"paint":{"text-halo-color":"rgba(255,255,255,1.00)","text-color":"rgba(63,63,63,1.00)","text-halo-width":1,"text-translate":[0,0]},"id":"Countries@World#1","source":"World","source-layer":"Countries_ip@World","type":"symbol","minzoom":2},{"layout":{"icon-rotation-alignment":"viewport","visibility":"visible","text-field":"{CAPITAL_LO}","text-size":10.17,"text-anchor":"top-left","text-allow-overlap":false,"icon-size":1,"symbol-placement":"point","icon-image":"marker_908020_7_7F7F7F","text-font":["Microsoft YaHei Regular"],"text-rotate":360,"text-letter-spacing":0,"text-justify":"left","text-rotation-alignment":"viewport","text-ignore-placement":false},"filter":["all",["==","$type","Point"],["has","CAPITAL_LO"],["!=","CAPITAL_LO",""]],"metadata":{"layer:caption":"Capital_Local"},"maxzoom":21,"paint":{"text-halo-color":"rgba(242,242,242,1.00)","text-color":"rgba(63,63,63,1.00)","text-halo-width":1,"text-translate":[0,0]},"id":"Capitals@World#2","source":"World","source-layer":"Capitals@World#2","type":"symbol","minzoom":3},{"layout":{"icon-rotation-alignment":"viewport","visibility":"visible","text-field":"{CAPITAL_CH}","text-size":10.17,"text-anchor":"bottom-left","text-allow-overlap":false,"icon-size":1,"symbol-placement":"point","icon-image":"marker_908020_7_7F7F7F","text-font":["Microsoft YaHei Regular"],"text-rotate":360,"text-letter-spacing":0,"text-justify":"left","text-rotation-alignment":"viewport","text-ignore-placement":false},"filter":["all",["==","$type","Point"],["has","CAPITAL_CH"],["!=","CAPITAL_CH",""]],"metadata":{"layer:caption":"Captial_CH"},"maxzoom":21,"paint":{"text-halo-color":"rgba(242,242,242,1.00)","text-color":"rgba(38,38,38,1.00)","text-halo-width":1,"text-translate":[0,0]},"id":"Capitals@World#3","source":"World","source-layer":"Capitals@World#3","type":"symbol","minzoom":3},{"layout":{"text-rotate":0,"visibility":"visible","text-letter-spacing":0,"text-field":"{MVT_TEXT}","text-rotation-alignment":"viewport","text-size":13.49,"text-allow-overlap":false,"text-ignore-placement":false,"symbol-placement":"point","text-font":["Microsoft YaHei Regular"]},"metadata":{"layer:caption":"Ocean_Label_1@World"},"maxzoom":21,"paint":{"text-halo-color":"rgba(255,255,255,1.00)","text-color":"rgba(0,117,169,1.00)","text-halo-width":1},"id":"Ocean_Label_1@World","source":"World","source-layer":"Ocean_Label_1@World","type":"symbol","minzoom":0},{"layout":{"text-rotate":0,"visibility":"visible","text-letter-spacing":0,"text-field":"{MVT_TEXT}","text-rotation-alignment":"viewport","text-size":27.95,"text-allow-overlap":false,"text-ignore-placement":false,"symbol-placement":"point","text-font":["Microsoft YaHei Regular"]},"metadata":{"layer:caption":"continent_T@World"},"maxzoom":2,"paint":{"text-halo-color":"rgba(255,255,255,1.00)","text-color":"rgba(127,127,127,1.00)","text-halo-width":1},"id":"continent_T@World","source":"World","source-layer":"continent_T@World","type":"symbol","minzoom":0}],"zoom":0.7,"glyphs":"http://localhost:8090/iserver/services/test/restjsr/v1/vectortile/maps/World/fonts/{fontstack}/{range}","version":8}

 

HEAD 请求

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

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

请参见

• map
• 客户端构建 REST 请求
• 状态码列表及说明
• SuperMap iServer REST API 表述格式介绍
• 资源层次结构