LabelsToMapTiles 类
此类用于 map.addLabelsToMapTile 方法,支持向底图上添加可参与碰撞的 label。通过此类可以在地图底图上添加自定义的文字标注,这些标注会与底图上的其他文字进行碰撞检测和避让。
属性
| 属性 | 类型 | 描述 |
|---|---|---|
| position | Point | 墨卡托坐标 |
| displayRange | Array | 显示的级别范围,[fromZoom, toZoom] |
| textMargin | number | 文字距离坐标位置的像素边距 |
| name | string | 显示的文字内容 |
| style | Object | 样式配置对象 |
style 对象的配置项
| 属性 | 类型 | 描述 |
|---|---|---|
| fontSize | number | 文字大小,单位像素 |
| fontWeight | string | 文字粗细,例如 'normal'、'bold' |
| color | string | 文字颜色,例如 '#000000' |
| strokeColor | string | 文字描边颜色 |
| strokeWidth | number | 文字描边宽度,单位像素 |
示例
javascript
// 创建标注配置
var labelConfig = {
position: new BMapGL.Point(116.404, 39.915),
displayRange: [3, 19], // 3-19级显示
textMargin: 5,
name: '自定义标注',
style: {
fontSize: 14,
fontWeight: 'bold',
color: '#333333',
strokeColor: '#ffffff',
strokeWidth: 2
}
};
// 添加标注到地图
map.addLabelsToMapTile([labelConfig]);相关方法
- Map.addLabelsToMapTile() - 添加标注到底图
- Map.removeLabelsFromMapTile() - 从底图移除标注
- Map.clearLabels() - 清除所有标注
注意事项
- 添加的标注会参与底图文字的碰撞检测
displayRange数组的两个值分别表示开始显示和结束显示的缩放级别position必须是有效的墨卡托坐标点style对象中的所有样式配置都是可选的- 标注的显示优先级由添加的顺序决定
