Symbol
符号样式。
示例
{
"id": "村庄-镇(10)",
"type": "symbol",
"source": "defaultVector",
"source-layer": "小村庄",
"minzoom": 10,
"filter": [
"all",
[
"==",
"Kind",
"260000"
]
],
"layout": {
"text-line-height": 1,
"visibility": "visible",
"text-max-width": 10,
"text-field": [
"get",
"Name"
],
"text-size": 12,
"text-font": [
"YaHei"
]
},
"paint": {
"icon-color": "rgba(181, 122, 122, 1)",
"text-color": "rgba(0, 167, 210, 1)"
}
}
图层基本属性
属性 |
说明 |
ID |
ID |
type |
类型,固定值"Symbol" |
source |
数据源 |
source-layer |
源图层 |
minzoom |
最小级别 |
maxzoom |
最大级别 |
maputnik:comment |
备注 |
通用布局属性
属性 |
说明 |
symbol-placement |
设置标签相对于其几何体的位置。 默认:point |
symbol-spacing |
设置两个符号锚点之间的距离 |
symbol-avoid-edges |
设置Symbol 避免边缘冲突。默认:false |
symbol-z-order |
设置Symbol在同一图层中重叠顺序 |
文本布局属性
属性 |
说明 |
text-field |
设置文本值。 |
text-font |
设置字体样式 |
text-size |
设置字体尺寸 |
text-line-height |
设置多行文本的前导值 |
text-padding |
设置文本内边距 |
text-allow-overlap |
如果为true,即使文本与其他先前绘制的符号发生碰撞,该文本也将可见。默认:false |
text-ignore-placement |
如果为true,即使其他符号与文本发生碰撞,也可以看到其他符号。默认:false |
text-pitch-alignment |
投放地图时文本的方向。 |
text-rotation-alignment |
与Symbol-Placement组合,确定文本的旋转行为。 |
text-max-width |
设置文本最大宽度 |
text-letter-spacing |
设置文本文字间距 |
text-justify |
设置文本对齐方式 |
text-anchor |
设置文本锚点 |
text-max-angle |
设置文本相邻字符之间的最大角度变化。 |
text-rotate |
设置文本顺时针旋转 |
text-keep-upright |
如果为true,则可以垂直翻转文本以防止其呈现倒置。默认:false |
text-transform |
设置文本字母大小写 |
text-offset |
设置文本与其锚点的偏移距离。 正值表示向右和向下,而负值表示向左和向上。 |
text-optional |
如果为true,则当文本与其他符号发生碰撞而图标没有碰撞时,图标将显示没有相应的文本。默认:false |
注:Field 值:
..,"text-field": [
"get",
"Name"
], ..
图标布局属性
属性 |
说明 |
icon-image |
设置 sprite 中绘制图像背景的图像名称 |
icon-allow-overlap |
如果为true,即使图标与其他先前绘制的符号发生碰撞,该图标也将可见。默认:false |
icon-ignore-placement |
如果为true,即使其他符号与图标发生碰撞,也可以看到其他符号。默认:false |
icon-optional |
如果为true,当图标与其他符号发生碰撞而文本没有碰撞时,文本将显示没有相应的图标。默认:false |
icon-rotation-alignment |
与Symbol-Placement组合,确定图标的旋转行为。 |
icon-size |
设置图标尺寸 |
icon-text-fit |
设置图标缩放,一适应相关文本 |
icon-text-fit-padding |
设置图标内边距,与text-fit组合使用 |
icon-rotate |
顺时针旋转图标 |
icon-padding |
设置图标内边距 |
icon-keep-upright |
如果为true,则可以翻转图标以防止其呈现倒置。默认:false |
icon-offset |
设置图标与其锚点的偏移距离。 |
icon-anchor |
设置图标最靠近锚点的的一部分。 |
icon-pitch-alignment |
设置投放地图时图标的方向。 |
文本绘制属性
属性 |
说明 |
text-opacity |
设置文本透明度 |
text-color |
设置文本颜色 |
text-halo-color |
文本光环的颜色,有助于它从背景中脱颖而出 |
text-halo-width |
光晕到字体宽度。 最大文本光晕宽度是字体大小的1/4。 |
text-halo-blur |
设置文本淡出外面的光环。 |
text-translate |
文本的锚点从其原始位置移动的距离。 正值表示向右和向下,而负值表示向左和向上。 |
text-translate-anchor |
设置text-translate的锚点 |
图标绘制属性
属性 |
说明 |
icon-opacity |
设置图标透明度 |
icon-color |
设置图标颜色,只能与sdf图标一起使用 |
icon-halo-color |
设置图标光晕的颜色,只能与sdf图标一起使用 |
icon-halo-width |
设置图标光晕的宽度 |
icon-halo-blur |
设置图标淡出外面的光环。 |
icon-translate |
图标的锚点从其原始位置移动的距离。 正值表示向右和向下,而负值表示向左和向上。 |
icon-translate-anchor |
设置icon-translate的锚点 |