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的锚点 |