mapbox基础,style样式汇总,持续更新

👨‍⚕️ 主页: gis分享者
👨‍⚕️ 感谢各位大佬 点赞👍 收藏⭐ 留言📝 加关注✅!
👨‍⚕️ 收录于专栏:mapbox 从入门到精通


一、🍀前言

style样式是mapbox的核心,本文详细介绍mapbox的style样式用法,方便查询使用。希望能帮助到您,感谢支持~

二、🍀根属性

version:版本号(必填,且值必须为 8)

"version": 8

name:名称(可选,用于给 style 取名,方便阅读)

"name": "myMap"

metadata:元数据(可选,用于给 style 附加一些任意属性。为避免冲突,为避免冲突,建议添加前缀,如 mapbox:)

"metadata": {
	"mapbox:name":"demo"
}

center:地图的默认中心点(可选,由 经度 和 纬度 构成)

"center": [116.4, 39.9]

zoom:地图的默认缩放层级(可选,值越大,越靠近地表。mapbox 采用的是无极缩放,范围一般为 0 ~ 24)

"zoom": 8

bearing:地图的默认方位角(可选,表示 地图视口正上方中心点 在地图上 北偏东 的角度。默认值为 0)

"bearing": 0

pitch:地图的默认倾斜角度(可选,默认值为 0,范围为 0 ~ 60)

"pitch": 0

sprite:雪碧图(可选,用来指定获取雪碧图及其元数据的 URL)

sprite 的音译是 雪碧,直译是 精灵,表示不受地图旋转缩放影响的图标等,类似精灵漂浮在空中。
当有 layer 使用了 background-pattern、fill-pattern、line-pattern、fill-extrusion-pattern、icon-image 等属性时,sprite 必填。

"sprite": "mapbox://sprites/mapbox/bright-v8"

当指定了 sprite 后,mapbox 会自动生成雪碧图的完整请求地址,分别如下:

`${sprite}.png`
`${sprite}.json`

如果浏览器进行了缩放,则会加上缩放 DPI 因子 @2x,如下:

`${sprite}@2x.png`
`${sprite}@2x.json`

glyphs:字形符号(可选,用来指定加载以 PBF 格式设置的 有向距离场 字形的 URL 模板)
URL 模板必须带有占位符 {fontstack} 和 {range}。
当有 layer 使用了 text-field 属性时,glyphs 必填。

"glyphs": "mapbox://fonts/mapbox/{fontstack}/{range}.pbf"

transition:全局的过渡动画属性(可选,用来作为所有过渡动画属性的默认值)

"transition": {
"duration": 300, // 过渡的持续时间(可选,单位:毫秒,默认值为 300)
"delay": 0 // 延迟多久开始过渡(可选,单位:毫秒,默认值为 0)
}

light:全局的光源(可选)

"light": {
	"anchor": "viewport", // 锚点,指定作用的目标(可选,可选值 map、viewport,默认值为 viewport)
	"position": [1.15,210,30], // 位置(可选,默认值为 [1.15,210,30])
	"color": "white", // 颜色(可选,默认值为 #ffffff)
	"intensity": 0.5 // 强度(可选,取值范围为 0 ~ 1,默认值为 0.5)
}

2.1 sources 属性

sources:数据源集合(必填,用于包含一系列数据源 source,这些数据源提供了在地图上显示的数据)
sources 是对象 {} 的形式,其属性名就是 数据源的名称(或者说 数据源的 id),这样可以根据 数据源的名称(或者说 数据源的 id)快速获取数据源的信

"sources": {}

每个数据源 source 都有一个 type 属性,用于指定其具体的类型:

  • vector:矢量
  • raster:栅格
  • raster-dem:栅格化的数字高程模型
  • geojson: 数据源
  • image:图片
  • video:视频

2.1.1 vector

vector:矢量切片数据源

"sources":{
	"vector-source": {
	"type": "vector", // 类型(必填)
	"url": "mapbox://mapbox.mapbox-streets-v6" // TileJSON 的请求地址(可选)
	"tiles": [ // 用于指定一个或多个切片数据源的请求地址(可选,和 TileJSON 中的 tiles 属性一致)
		"http://a.example.com/tiles/{z}/{x}/{y}.pbf",
		"http://b.example.com/tiles/{z}/{x}/{y}.pbf"
	],
	"bounds": [-180,-85.051129,180,85.051129], // 边界坐标点(可选,用于限定切片的显示范围,默认值为 [-180,-85.051129,180,85.051129])
	"scheme":"xyz", // 切片坐标系方案(可选,可选值为 xyz、tms,默认值为 xyz)
	"minzoom": 0, // 最小层级(可选,默认值为 0)
	"maxzoom": 22, // 最大层级(可选,默认值为 22)
	"attribution": "" // 属性信息(可选,用于地图展示时给用户看的一些信息)
	}
}

2.1.2 raster

raster:栅格切片数据源(相比 vector 多了一个属性 tileSize)

"sources":{
	"raster-source": {
	"type": "raster", // 类型(必填)
	"url": "mapbox://mapbox.satellite" // TileJSON 的请求地址(可选)
	"tiles": [ // 用于指定一个或多个切片数据源的请求地址(可选,和 TileJSON 中的 tiles 属性一致)
		"http://a.example.com/tiles/{z}/{x}/{y}.pbf",
		"http://b.example.com/tiles/{z}/{x}/{y}.pbf"
	],
	"bounds": [-180,-85.051129,180,85.051129], // 边界坐标点(可选,用于限定切片的显示范围,默认值为 [-180,-85.051129,180,85.051129])
	"scheme":"xyz", // 切片坐标系方案(可选,可选值为 xyz、tms,默认值为 xyz)
	"minzoom": 0, // 最小层级(可选,默认值为 0)
	"maxzoom": 22, // 最大层级(可选,默认值为 22)
	"attribution": "", // 属性信息(可选,用于地图展示时给用户看的一些信息)
	"tileSize": 256 // 切片的最小展示尺寸(可选,单位:像素,默认值为 512,即 1024/2)
	}	
}

2.1.3 raster-dem

raster-dem:栅格化的数字高程模型(相比 raster 多了一个属性 encoding)

"sources":{
	"raster-dem-source": {
	"type": "raster-dem", // 类型(必填)
	"url": "mapbox://mapbox.terrain-rgb" // TileJSON 的请求地址(可选)
	"tiles": [ // 用于指定一个或多个切片数据源的请求地址(可选,和 TileJSON 中的 tiles 属性一致)
		"http://a.example.com/tiles/{z}/{x}/{y}.pbf",
		"http://b.example.com/tiles/{z}/{x}/{y}.pbf"
	],
	"bounds": [-180,-85.051129,180,85.051129], // 边界坐标点(可选,用于限定切片的显示范围,默认值为 [-180,-85.051129,180,85.051129])
	"scheme":"xyz", // 切片坐标系方案(可选,可选值为 xyz、tms,默认值为 xyz)
	"minzoom": 0, // 最小层级(可选,默认值为 0)
	"maxzoom": 22, // 最大层级(可选,默认值为 22)
	"attribution": "", // 属性信息(可选,用于地图展示时给用户看的一些信息)
	"tileSize": 256, // 切片的最小展示尺寸(可选,单位:像素,默认值为 512,即 1024/2)
	"encoding": "mapbox" // 编码(可选,可选值为 terrarium、mapbox,默认值为 mapbox)
	}
}

2.1.4 geojson

geojson: 数据源(数据必须通过 data 属性指定,data 属性值就是一个 GeoJSON 或者 GeoJSON 的请求地址)

"sources": {
	"geojson-source": {
	"type": "geojson", // 类型(必填)
	"data": { // 数据(可选,值必须为一个 GeoJSON 或者 GeoJSON 的请求地址)
		"type": "Feature",
		"geometry": {
			"type": "Point",
			"coordinates": [-77.0323, 38.9131]
		},
		"properties": {
		"title": "Mapbox DC",
		"marker-symbol": "monument"
		}
	},
	// "data": "./lines.geojson",
	"maxzoom": 22, // 最大层级(可选,默认值为 22)
	"attribution": "", // 属性信息(可选,用于地图展示时给用户看的一些信息)
	"buffer": 128, // 切片缓存区大小(可选,取值范围为 0 ~ 512,默认值为 128,如果取值为 512 则代表和切片大小一样)
	"tolerance": 0.375, // 简化力度(可选,值越大简化力度越强,几何顶点越少,加载速度越快,默认值为 0.375)
	"cluster": false, // 是否开启聚类(可选,用于将多个点聚类到一个个的群组,默认值为 false)
	"clusterRadius": 50, // 每个群组的的半径(可选,默认值为 50)
	"clusterMaxZoom": 12, // 每个群组的最大层级(大于指定的层级将不显示聚类的群组)
	"lineMetrics": false, // 是否计算线的距离度量(额,有点不能理解,需要 layer 指定 line-gradient)
	"generateId": false // 是否自动生成每个要素生成属性 id 的值
	}
}

2.1.6 image

image:图片数据源

"sources": {
	"image-source": {
	"type": "image", // 类型(必填)
	"url": "https://docs.mapbox.com/mapbox-gl-js/assets/radar.gif", // 图片的请求地址(必填)
	"coordinates": [ // 坐标点集合(必填,指定要显示图片的坐标点)
		[-80.425, 46.437],
		[-71.516, 46.437],
		[-71.516, 37.936],
		[-80.425, 37.936]
		]
	}
}

2.1.5 video

video:视频数据源

"sources": {
	"video-source": {
	"type": "video", // 类型(必填)
	"urls": [ // 一个或多个视频的请求地址(必填,指定多个是为了支持多种视频格式,按优先顺序排序) 			"https://static-assets.mapbox.com/mapbox-gl-js/drone.mp4", "https://static-assets.mapbox.com/mapbox-gl-js/drone.webm"
	],
	"coordinates": [ // 坐标点集合(必填,指定要显示视频的坐标点)
		[-80.425, 46.437],
		[-71.516, 46.437],
		[-71.516, 37.936],
		[-80.425, 37.936]
		]
	}
}

2.2 layers 属性

layers:图层集合(必填,包含了一系列图层 layer,这些图层指定了如何渲染数据源提供的数据)
每个图层 layer 都有 id(具有唯一性)和 type 属性,其中 type 属性指定了其具体的渲染类型:

  • fill:填充
  • line:线
  • circle:圆点
  • symbol:符号
  • background:背景
  • raster:栅格
  • heatmap:热力图
  • hillshade:坡面阴影
  • fill-extrusion:三维填充
"layers": []

2.2.1 fill

fill:填充(用于给多边形 polygon 进行填充和描边)

"layers": [
	{
	"id": "fill-id", // 唯一 id (必填)
	"type": "fill", // 类型(必填)
	"metadata": { // 元数据(可选,用于为 layer 附加任意的属性。为避免冲突,建议添加前缀,如 mapbox:)
		"mapbox:name": "test"
	},
	"source": "source-name", // 数据源的名称(除了 layer 的 type 为 background 外,source 必填)
	"source-layer": "source-layer-name", // 数据源的图层(只有数据源 source 的 type 为 vector 时,才能设置 source-layer,其他类型的不可以设置)
	"minzoom": 0, // 最小层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时,layer 将被隐藏)
	"maxzoom": 24, // 最大层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时,layer 将被隐藏)
	"filter": [], // 过滤(可选,用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression)
	"layout": { // 布局类属性
		"visibility": "visible", // 可见性(可选,可选值为 none、visible,默认值为 visible)
	},
	"paint": { // 绘制类属性
		"fill-antialias": true, // 填充时是否反锯齿(可选,默认值为 true)
		"fill-opacity": 1, // 填充的不透明度(可选,取值范围为 0 ~ 1,默认值为 1)
		"fill-pattern": "", // 填充用的图案(可选,这里填写在 sprite 雪碧图中图标名称。为了图案能无缝填充,图标的高宽需要是 2 的倍数)
		"fill-color": "#000000", // 填充的颜色(可选,默认值为 #000000。如果设置了 fill-pattern,则 fill-color 将无效)
		"fill-outline-color": "#000000", // 描边的颜色(可选,默认和 fill-color 一致。如果设置了 fill-pattern,则 fill-outline-color 将无效。为了使用此属性,还需
		"fill-translate": [0, 0], // 填充的平移(可选,通过平移 [x, y] 达到一定的偏移量。默认值为 [0, 0],单位:像素。)
		"fill-translate-anchor": "map" // 平移的锚点,即相对的参考物(可选,可选值为 map、viewport,默认为 map)
	}
	}	
]

2.2.2 line

line:线(用于绘制成一条条线)

"layers": [
	{
	"id": "line-id", // 唯一 id (必填)
	"type": "line", // 类型(必填)
	"metadata": { // 元数据(可选,用于为 layer 附加任意的属性。为避免冲突,建议添加前缀,如 mapbox:)
		"mapbox:name": "test"
	},
	"source": "source-name", // 数据源的名称(除了 layer 的 type 为 background 外,source 必填)
	"source-layer": "source-layer-name", // 数据源的图层(只有数据源 source 的 type 为 vector 时,才能设置 source-layer,其他类型的不可以设置)
	"minzoom": 0, // 最小层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时,layer 将被隐藏)
	"maxzoom": 24, // 最大层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时,layer 将被隐藏)
	"filter": [], // 过滤(可选,用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression)
	"layout": { // 布局类属性
		"visibility": "visible", // 可见性(可选,可选值为 none、visible,默认值为 visible)
		"line-cap": "butt", // 线末端的显示样式(可选,可选值为 butt、round、square,默认值为 butt)
		//	--- butt:方型末端(仅绘制到线的端点)
		//	--- round:圆型末端(以线宽的 1/2 为半径,以线的端点为圆心,绘制圆型端点,会超出线的端点)
		//	--- square:方型末端(以线宽的 1/2 长度超出线的端点)
		"line-join": "miter", // 线交叉时的显示样式(可选,可选值为 bevel、round、miter,默认值为 miter)
		//	--- bevel:方型交点(以线宽的 1/2 长度超出线的交点)
		//	--- round:圆型交点(以线宽的 1/2 为半径,以线的交点为圆心,绘制圆型交点,会超出线的交点)
		//	--- miter:尖型交点(以两线段的外沿相交,超出交点绘制)
		"line-miter-limit": 2, // 最大斜接长度(可选,用来将 miter 尖型交点自动转为 bevel 方型交点,默认值为 2。只有 line-join 为 miter 时,才需要设置此属
		"line-round-limit": 1.05, // 最小圆角半径(可选,用来将 round 圆型交点自动转为 miter 尖型交点,默认值为 1.05。只有 line-join 为 round 时,才需要
	},
	"paint": { // 绘制类属性
		"line-opacity": 1, // 线的不透明度(可选,取值范围为 0 ~ 1,默认值为 1)
		"line-pattern": "", // 线用的图案(可选,这里填写在 sprite 雪碧图中图标名称。为了图案能无缝填充,图标的高宽需要是 2 的倍数)
		"line-color": "#000000", // 线的颜色(可选,默认值为 #000000。如果设置了 line-pattern,则 line-color 将无效)
		"line-translate": [0, 0], // 线的平移(可选,通过平移 [x, y] 达到一定的偏移量。默认值为 [0, 0],单位:像素。)
		"line-translate-anchor": "map", // 线的平移锚点,即相对的参考物(可选,可选值为 map、viewport,默认为 map)
		"line-width": 1, // 线的宽度(可选,值 >= 0,默认值为 1,单位:像素)
		"line-gap-width": 0, // 线的外部间距宽度(可选,值 >= 0,默认值为 0,单位:像素。用来在线的外部再绘制一部分,此值表示内间距)
		"line-offset": 0, // 线的偏移(可选,默认值为 0,单位:像素。对于单线,则是向右的偏移量;对于多边形,正值为内缩 inset,负值为外突 outset)
		"line-blur": 0, // 线的模糊度(可选,值 >= 0,默认值为 0,单位:像素)
		"line-dasharray": [0, 0], // 虚线的破折号部分和间隔的长度(可选,默认值为 [0, 0]。如果设置了 line-pattern,则 line-dasharray 将无效)
		"line-gradient": "#000000", // 线的渐变色(可选。如果设置了 line-pattern 或 line-dasharray,则 line-gradient 将无效。只有数据源 source 的 type 为
	}
	}
]

2.2.3 circle

circle:圆点(用于绘制成一个个圆点)

"layers": [
	{
	"id": "circle-id", // 唯一 id (必填)
	"type": "circle", // 类型(必填)
	"metadata": { // 元数据(可选,用于为 layer 附加任意的属性。为避免冲突,建议添加前缀,如 mapbox:)
		"mapbox:name": "test"
	},
	"source": "source-name", // 数据源的名称(除了 layer 的 type 为 background 外,source 必填)
	"source-layer": "source-layer-name", // 数据源的图层(只有数据源 source 的 type 为 vector 时,才能设置 source-layer,其他类型的不可以设置)
	"minzoom": 0, // 最小层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时,layer 将被隐藏)
	"maxzoom": 24, // 最大层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时,layer 将被隐藏)
	"filter": [], // 过滤(可选,用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression)
	"layout": { // 布局类属性
		"visibility": "visible", // 可见性(可选,可选值为 none、visible,默认值为 visible)
	},
	"paint": { // 绘制类属性
		"circle-opacity": 1, // 圆点的不透明度(可选,取值范围为 0 ~ 1,默认值为 1)
		"circle-radius": 5, // 圆点的半径(可选,值 >= 0,默认值为 5,单位:像素)
		"circle-color": "#000000", // 圆点的颜色(可选,默认值为 #000000)
		"circle-blur": 0, // 圆点的虚化(可选,默认值为 0。当值为 1 时,表示把圆虚化到只有圆心是不透明的)
		"circle-translate": [0, 0], // 圆点的平移(可选,通过平移 [x, y] 达到一定的偏移量。默认值为 [0, 0],单位:像素。)
		"circle-translate-anchor": "map", // 圆点的平移锚点,即相对的参考物(可选,可选值为 map、viewport,默认为 map)
		"circle-pitch-scale": "map", // 地图倾斜时圆点的缩放(可选,可选值为 map、viewport,默认为 map。值为 viewport 时,圆点不会缩放)
		"circle-pitch-alignment": "map", // 地图倾斜时圆点的对齐方式(可选,可选值为 map、viewport,默认为 map)
		"circle-stroke-width": 0, // 圆点的描边宽度(可选,值 >= 0,默认值为 0,单位:像素)
		"circle-stroke-color": "#000000", // 圆点的描边颜色(可选,默认值为 #000000)
		"circle-stroke-opacity": 1 // 圆点的描边不透明度(可选,取值范围为 0 ~ 1,默认值为 1)
	}
	}
] 

2.2.4 symbol

symbol:符号(用于绘制成一个个图标或者文本标签等)

"layers": [
	{
	"id": "symbol-id", // 唯一 id (必填)
	"type": "symbol", // 类型(必填)
	"metadata": { // 元数据(可选,用于为 layer 附加任意的属性。为避免冲突,建议添加前缀,如 mapbox:)
		"mapbox:name": "test"
	},
	"source": "source-name", // 数据源的名称(除了 layer 的 type 为 background 外,source 必填)
	"source-layer": "source-layer-name", // 数据源的图层(只有数据源 source 的 type 为 vector 时,才能设置 source-layer,其他类型的不可以设置)
	"minzoom": 0, // 最小层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时,layer 将被隐藏)
	"maxzoom": 24, // 最大层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时,layer 将被隐藏)
	"filter": [], // 过滤(可选,用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression)
	"layout": { // 布局类属性
		"visibility": "visible", // 可见性(可选,可选值为 none、visible,默认值为 visible)
		"symbol-placement": "point", // 符号的位置(可选,可选值为 point、line、line-center,默认值为 point)
		//	--- point:符号在几何形状的点上
		//	--- line:符号在几何形状的线上(几何形状只能为 LineString 或 Polygon)
		//	--- line-center:符号在几何形状的线的中心点上(几何形状只能为 LineString 或 Polygon)
		"symbol-spacing": 250, // 符号之间的距离(可选,值 >= 1,默认值为 250,单位:像素。只有 symbol-placement 为 line 时才有效)
		"symbol-avoid-edges": false, // 是否避免边缘冲突(可选,默认值为 false。当为 true 时,符号不会超过切片的边缘)
		"symbol-sort-key": 1, // 排序的参考值(可选,无默认值。值越大,越在上方)
		"symbol-z-order": "auto", // z 轴上的顺序控制(可选,可选值为 auto、viewport-y、source,默认值为 auto)
		//	图标类属性(需要设置 icon-image)
		"icon-image": "", // 图标的图片(可选,这里填写在 sprite 雪碧图中图标名称)
		"icon-size": 1, // 图标的大小(可选,值 >= 0,默认值为 1。这里实际上是图标对应的原始图片的大小的缩放比例。值为 1 表示图标大小为原始图片的大
		"icon-padding": 2, // 图标的外边距(可选,值 >= 0,默认值为 2。可用于碰撞检测)
		"icon-offset": [0, 0], // 图标的偏移量(可选,默认值为 [0, 0])
		"icon-anchor": "center", // 图标与锚点的位置关系(可选,可选值为 center、left、right、top、bottom、top-left、top-right、bottom-left、bottom-right
		"icon-rotation": 0, // 图标的顺时针旋转角度(可选,默认值为 0,单位:角度)
		"icon-allow-overlap": false, // 是否允许图标重叠(可选,默认值为 false。当值为 true 时,图标即使和其他符号触碰也会显示)
		"icon-ignore-placement": false, // 是否忽略图标位置(可选,默认值为 false。当值为 true 时,其他符号即使与此图标触碰也会显示)
		"icon-optional": false, // 图标是否可不显示(可选,默认值为 false。当值为 true 时,如果图标与文本标签碰撞,则显示文本标签)
		"icon-text-fit": "none", // 图标与文本的大小适应关系(可选,可选值为 none、width、height、both,默认值为 none)
		//	--- none:图标按其本身的比例显示
		//	--- width:图标在 x 轴上缩放以适应文本的宽度
		//	--- height:图标在 y 轴上缩放以适应文本的高度
		//	--- both:图标在 x 和 y 轴上缩放以适应文本的宽高
		"icon-text-fit-padding": [0, 0, 0, 0], // 图标与文本的内边距(可选,默认值为 [0,0,0,0],单位:像素)
		"icon-keep-upright": false, // 当 icon-rotation-alignment 为 map,且 symbol-placement 为 line 或者 line-center 时,设置为 true 的话,可以避免图标
		"icon-rotation-alignment": "auto", // 地图旋转时图标的对齐方式(可选,可选值为 map、viewport、auto,默认值为 auto)
		//	--- map:当 symbol-placement 为 point 时,图标与地图的东西方向对齐;当 symbol-placement 为 line 时,图标的 x 轴和线对齐
		//	--- viewport:图标的 x 轴和视口的 x 轴对齐
		//	--- auto:当 symbol-placement 为 point 时,和 viewport 一致;当 symbol-placement 为 line 时,和 map 一致
		"icon-pitch-alignment": "auto", // 地图倾斜时图标的对齐方式(可选,可选值为 map、viewport、auto,默认值为 auto)
		//	--- map:图标的 x 轴与地图平面对齐
		//	--- viewport:图标的 x 轴和视口的 x 轴对齐
		//	--- auto:当 symbol-placement 为 point 时,和 viewport 一致;当 symbol-placement 为 line 时,和 map 一致
		//	文本类属性(需要指定 text-field)
		"text-rotation-alignment": "auto", // 与 icon-rotation-alignment 类似
		"text-pitch-alignment": "auto", // 与 icon-pitch-alignment 类似
		"text-field": "", // 文本所对应的字段(可选,默认值为 "")
		"text-font": ["Open Sans Regular","Arial Unicode MS Regular"], // 文本的字体集合(可选,默认值为 ["Open Sans Regular","Arial Unicode MS Regul
		"text-size": 16, // 文本的大小(可选,默认值为 16,单位:像素)
		"text-max-width": 10, // 文本的最大宽度,超过则折行(可选,默认值为 10,单位:ems)
		"text-line-height": 1.2, // 文本的行高(可选,默认值为 1.2,单位:ems)
		"text-letter-spacing": 0, // 文本的字符间距(可选,默认值为 0,单位:ems)
		"text-justify": "center", // 文本的水平对齐方式(可选,可选值为 auto、left、center、right。默认值为 center)
		"text-anchor": "center", // 文本与锚点的位置关系(可选,可选值为 center、left、right、top、bottom、top-left、top-right、bottom-left、bottom-right
		"text-variable-anchor": "center", // 与 text-anchor(优先级更高) 类似,有点不懂
		"text-max-angle": 45, // 当 symbol-placement 为 line 或 line-center 时,文本相邻字符的最大夹角,默认 45 度
		"text-rotate": 0, // 文本的顺时针旋转角度(可选,默认值为 0,单位:角度)
		"text-padding": 2, // 文本的外边距(可选,值 >= 0,默认值为 2。可用于碰撞检测)
		"text-keep-upright": false, // 当 icon-rotation-alignment 为 map,且 symbol-placement 为 line 或者 line-center 时,设置为 true 的话,可以避免文本上
		"text-transform": "none", // 文本大小写转换(可选,可选值为 none、uppercase、lowercase,默认值为 none)
		"text-offset": [0, 0], // 图标的偏移量(可选,默认值为 [0, 0])
		"text-radial-offset": 0, // 文本的径向偏移量,优先级比 text-offset 高
		"text-allow-overlap": false, // 是否允许文本重叠(可选,默认值为 false。当值为 true 时,文本即使和其他符号触碰也会显示)
		"text-ignore-placement": false, // 是否忽略文本位置(可选,默认值为 false。当值为 true 时,其他符号即使与此文本触碰也会显示)
		"text-optional": false // 文本是否可不显示(可选,默认值为 false。当值为 true 时,如果文本与图标碰撞,则显示图标)
	},
	"paint": { // 绘制类属性
		 //	图标类属性(需要设置 icon-image)
		"icon-opacity": 1, // 图标的不透明度(可选,取值范围为 0 ~ 1,默认值为 1)
		"icon-color": "#000000", // 图标的颜色(可选,默认值为 #000000)
		"icon-halo-color": "rgba(0,0,0,0)", // 图标的光晕颜色(可选,默认值为 rgba(0,0,0,0))
		"icon-halo-width": 0, // 图标的光晕宽度(可选,值 >= 0,默认值为 0,单位:像素)
		"icon-halo-blur": 0, // 图标的光晕模糊宽度(可选,值 >= 0,默认值为 0,单位:像素)
		"icon-translate": [0, 0], // 图标的平移(可选,通过平移 [x, y] 达到一定的偏移量。默认值为 [0, 0],单位:像素。)
		"icon-translate-anchor": "map", // 图标的平移锚点,即相对的参考物(可选,可选值为 map、viewport,默认为 map)
		//	文本类属性(需要设置 text-field)
		"text-opacity": 1, // 文本的不透明度(可选,取值范围为 0 ~ 1,默认值为 1)
		"text-color": "#000000", // 文本的颜色(可选,默认值为 #000000)
		"text-halo-color": "rgba(0,0,0,0)", // 文本的光晕颜色(可选,默认值为 rgba(0,0,0,0))
		"text-halo-width": 0, // 文本的光晕宽度(可选,值 >= 0,默认值为 0,单位:像素)
		"text-halo-blur": 0, // 文本的光晕模糊宽度(可选,值 >= 0,默认值为 0,单位:像素)
		"text-translate": [0, 0], // 文本的平移(可选,通过平移 [x, y] 达到一定的偏移量。默认值为 [0, 0],单位:像素。)
		"text-translate-anchor": "map", // 文本的平移锚点,即相对的参考物(可选,可选值为 map、viewport,默认为 map)
	}
	}
]

2.2.5 background

background:背景(用于绘制成整个地图的背景或者图案)

"layers": [
	{
	"id": "background-id", // 唯一 id (必填)
	"type": "background", // 类型(必填)
	"metadata": { // 元数据(可选,用于为 layer 附加任意的属性。为避免冲突,建议添加前缀,如 mapbox:)
		"mapbox:name": "test"
	},
	"minzoom": 0, // 最小层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时,layer 将被隐藏)
	"maxzoom": 24, // 最大层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时,layer 将被隐藏)
	"layout": { // 布局类属性
		"visibility": "visible", // 可见性(可选,可选值为 none、visible,默认值为 visible)
	},
	"paint": { // 绘制类属性
		"background-color": "#000000", // 背景颜色(可选,默认值为 #000000。如果设置了 background-pattern,则 background-color 将无效)
		"background-pattern": "", // 背景图案(可选,这里填写在 sprite 雪碧图中图标名称。为了背景图案能无缝填充,图标的高宽需要是 2 的倍数)
		"background-opacity": 1 // 背景不透明度(可选,取值范围为 0 ~ 1,默认值为 1)
	}
	}
]

2.2.6 raster

raster:栅格(用于绘制栅格地图,比如卫星影像)

"layers": [
	{
	"id": "raster-id", // 唯一 id (必填)
	"type": "raster", // 类型(必填)
	"metadata": { // 元数据(可选,用于为 layer 附加任意的属性。为避免冲突,建议添加前缀,如 mapbox:)
		"mapbox:name": "test"
	},
	"source": "source-name", // 数据源的名称(除了 layer 的 type 为 background 外,source 必填)
	"source-layer": "source-layer-name", // 数据源的图层(只有数据源 source 的 type 为 vector 时,才能设置 source-layer,其他类型的不可以设置)
	"minzoom": 0, // 最小层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时,layer 将被隐藏)
	"maxzoom": 24, // 最大层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时,layer 将被隐藏)
	"filter": [], // 过滤(可选,用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression)
	"layout": { // 布局类属性
		"visibility": "visible", // 可见性(可选,可选值为 none、visible,默认值为 visible)
	},
	"paint": { // 绘制类属性
		"raster-opacity": 1, // 图片的不透明度(可选,取值范围为 0 ~ 1,默认值为 1)
		"raster-hue-rotate": 0, // 在色轮上旋转色相的角度(可选,默认值为 0,单位:角度)
		"raster-brightness-min": 0, // 图片的最小亮度(可选,取值范围为 0 ~ 1,默认值为 0)
		"raster-brightness-max": 1, // 图片的最大亮度(可选,取值范围为 0 ~ 1,默认值为 1)
		"raster-saturation": 0, // 图片的饱和度(可选,取值范围为 -1 ~ 1,默认值为 0)
		"raster-contrast": 0, // 图片的对比度(可选,取值范围为 -1 ~ 1,默认值为 0)
		"raster-resampling": "linear", // 采样方式(可选,可选值为 linear、nearest,默认值为 linear)
		"raster-fade-duration": 300 // 切换瓦片时的渐隐时间(可选,默认值为 300,单位:毫秒)
	}
	}
]

2.2.7 heatmap

heatmap:热力图(用于绘制成热力图的效果)

"layers": [
	{
	"id": "heatmap-id", // 唯一 id (必填)
	"type": "heatmap", // 类型(必填)
	"metadata": { // 元数据(可选,用于为 layer 附加任意的属性。为避免冲突,建议添加前缀,如 mapbox:)
	"mapbox:name": "test"
	},
	"source": "source-name", // 数据源的名称(除了 layer 的 type 为 background 外,source 必填)
	"source-layer": "source-layer-name", // 数据源的图层(只有数据源 source 的 type 为 vector 时,才能设置 source-layer,其他类型的不可以设置)
	"minzoom": 0, // 最小层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时,layer 将被隐藏)
	"maxzoom": 24, // 最大层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时,layer 将被隐藏)
	"filter": [], // 过滤(可选,用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression)
	"layout": { // 布局类属性
		"visibility": "visible", // 可见性(可选,可选值为 none、visible,默认值为 visible)
	},
	"paint": { // 绘制类属性
		"heatmap-opacity": 1, // 热力图的不透明度(可选,取值范围为 0 ~ 1,默认值为 1)
		"heatmap-radius": 30, // 一个热力图点的影响半径(可选,值 >= 1,默认值为 30,单位:像素)
		"heatmap-weight": 1, // 一个热力图点的权重(可选,值 >= 0,默认值为 1)
		"heatmap-intensity": 1, // 热力图的强度,控制了所有的热力图点(可选,值 >= 0,默认值为 1)
		"heatmap-color": [ // 热力图的颜色变化(可选,默认值如下)
			"interpolate", ["linear"], ["heatmap-density"],
			0, "rgba(0, 0, 255, 0)",
			0.1, "royalblue",
			0.3, "cyan",
			0.5, "lime",
			0.7, "yellow",
			1, "red"
		]
	}
	}
]

2.2.8 hillshade

hillshade:坡面阴影(基于 DEM 数字高程模型进行坡面阴影的可视化渲染)

"layers": [
	{
	"id": "hillshade-id", // 唯一 id (必填)
	"type": "hillshade", // 类型(必填)
	"metadata": { // 元数据(可选,用于为 layer 附加任意的属性。为避免冲突,建议添加前缀,如 mapbox:)
		"mapbox:name": "test"
	},
	"source": "source-name", // 数据源的名称(除了 layer 的 type 为 background 外,source 必填)
	"source-layer": "source-layer-name", // 数据源的图层(只有数据源 source 的 type 为 vector 时,才能设置 source-layer,其他类型的不可以设置)
	"minzoom": 0, // 最小层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时,layer 将被隐藏)
	"maxzoom": 24, // 最大层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时,layer 将被隐藏)
	"filter": [], // 过滤(可选,用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression)
	"layout": { // 布局类属性
		"visibility": "visible", // 可见性(可选,可选值为 none、visible,默认值为 visible)
	},
	"paint": { // 绘制类属性
		"hillshade-illumination-direction": 335, // 光照的方向(可选,取值范围为 0 ~ 359,默认值为 335,单位:角度)
		"hillshade-illumination-anchor": "viewport", // 光照的锚点(可选,可选值为 map、viewport,默认值为 viewport)
		"hillshade-exaggeration": 0.5, // 阴影的强度(可选,取值范围为 0 ~ 1,默认值为 0.5)
		"hillshade-shadow-color": "#000000", // 阴影的颜色(可选,默认值为 #000000)
		"hillshade-highlight-color": "#ffffff", // 光照部分的颜色(可选,默认值为 #ffffff)
		"hillshade-accent-color": "#000000" // 用于强调地形的颜色(可选,默认值为 #000000)
	}
	}
]

2.2.9 fill-extrusion

fill-extrusion:三维填充(用于给三维多边形进行填充和描边)

"layers": [
	{
	"id": "fill-extrusion-id", // 唯一 id (必填)
	"type": "fill-extrusion", // 类型(必填)
	"metadata": { // 元数据(可选,用于为 layer 附加任意的属性。为避免冲突,建议添加前缀,如 mapbox:)
		"mapbox:name": "test"
	},
	"source": "source-name", // 数据源的名称(除了 layer 的 type 为 background 外,source 必填)
	"source-layer": "source-layer-name", // 数据源的图层(只有数据源 source 的 type 为 vector 时,才能设置 source-layer,其他类型的不可以设置)
	"minzoom": 0, // 最小层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时,layer 将被隐藏)
	"maxzoom": 24, // 最大层级(可选,取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时,layer 将被隐藏)
	"filter": [], // 过滤(可选,用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression)
	"layout": { // 布局类属性
		"visibility": "visible", // 可见性(可选,可选值为 none、visible,默认值为 visible)
	},
	"paint": { // 绘制类属性
		"fill-extrusion-opacity": 1, // 三维填充的不透明度(可选,取值范围为 0 ~ 1,默认值为 1)
		"fill-extrusion-pattern": "", // 三维填充的图案(可选,这里填写在 sprite 雪碧图中图标名称。为了图案能无缝填充,图标的高宽需要是 2 的倍数)
		"fill-extrusion-color": "#000000", // 三维填充的颜色(可选,默认值为 #000000)
		"fill-extrusion-translate": [0, 0], // 三维填充的平移(可选,通过平移 [x, y] 达到一定的偏移量。默认值为 [0, 0],单位:像素。)
		"fill-extrusion-translate-anchor": "map", // 平移的锚点,即相对的参考物(可选,可选值为 map、viewport,默认为 map)
		"fill-extrusion-height": 0, // 三维填充的高度(可选,值 >= 0,默认值为 0,单位:米)
		"fill-extrusion-base": 0, // 三维填充的底部高度(可选,值 >= 0,默认值为 0,单位:米。值必须小于等于 fill-extrusion-height)
		"fill-extrusion-vertical-gradient": true, // 是否开启垂直渐变(可选,默认值为 true)
	}
	}
]

三、🍀总结

当前style样式基于mapbox V2.* 版本的, V3.* mapbox新增了很多特性,后面持续更新。感谢支持~

评论 38
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

gis分享者

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值