Skip to content

LabelsToMapTiles 类

此类用于 map.addLabelsToMapTile 方法,支持向底图上添加可参与碰撞的 label。通过此类可以在地图底图上添加自定义的文字标注,这些标注会与底图上的其他文字进行碰撞检测和避让。

属性

属性类型描述
positionPoint墨卡托坐标
displayRangeArray显示的级别范围,[fromZoom, toZoom]
textMarginnumber文字距离坐标位置的像素边距
namestring显示的文字内容
styleObject样式配置对象

style 对象的配置项

属性类型描述
fontSizenumber文字大小,单位像素
fontWeightstring文字粗细,例如 'normal'、'bold'
colorstring文字颜色,例如 '#000000'
strokeColorstring文字描边颜色
strokeWidthnumber文字描边宽度,单位像素

示例

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]);

相关方法

注意事项

  1. 添加的标注会参与底图文字的碰撞检测
  2. displayRange 数组的两个值分别表示开始显示和结束显示的缩放级别
  3. position 必须是有效的墨卡托坐标点
  4. style 对象中的所有样式配置都是可选的
  5. 标注的显示优先级由添加的顺序决定

基于 MIT 许可发布