热力图可视化图层,把点数据按权重渲染成热力分布,适合密度/热度展示。

几何类型支持 Point / MultiPoint,点权重取 properties[weightField](默认字段 count)。 是旧 BMapGL.Heatmap 的原地平替,用法不变。

构造函数

  • 创建热力图图层

    参数类型说明
    options 可选HeatmapOptions配置项
    属性类型说明
    dataany初始数据,同 Heatmap.setData 的入参
    gradient{ [stop: number]: string }渐变色,如 { 0.25: 'rgba(0,0,255,1)', 1: 'rgba(255,0,0,1)' }。 键为 [0,1] 的位置,值为 css 颜色
    idKeystring取要素 id 的字段名
    maxnumber权重归一化上界
    maxOpacitynumber最大透明度 [0,1]
    maxZoomnumber最大显示缩放等级
    minnumber权重归一化下界
    minOpacitynumber最小透明度 [0,1]
    minZoomnumber最小显示缩放等级
    opacitynumber图层级透明度 [0,1]
    referCenterPoint图层参考中心点,规避大坐标浮点抖动
    renderStageRenderStage绘制阶段,取值见 RenderStage
    sizenumber热力核半径,单位由 unit 决定
    unit"m" | "px"半径单位:'px' 屏幕像素 / 'm' 墨卡托米
    visibleboolean是否显示
    weightFieldstring权重字段名(取 properties[weightField] 作为点权重)
    zIndexnumber显示层级,小的先画

    返回值 Heatmap

    示例代码1

    const layer = new BMap.Heatmap({ size: 20, max: 100 });
    layer.setData({
    type: 'FeatureCollection',
    features: [
    { type: 'Feature', geometry: { type: 'Point', coordinates: [116.404, 39.915] }, properties: { count: 30 } }
    ]
    });
    map.addLayer(layer);

数据

  • 返回原始数据

    返回值 any

  • 设置数据,支持 FeatureCollection / Feature / Feature[] / 裸 Geometry。 几何类型支持 Point / MultiPoint

    参数类型说明
    geojsonany

    返回值 Heatmap

显示属性

  • 返回值 number

  • 返回值 "building" | "poi"

  • 返回值 boolean

  • 返回值 number

  • 参数类型说明
    opacitynumber

    返回值 void

  • 参数类型说明
    centerPoint

    返回值 void

  • 参数类型说明
    stage"building" | "poi"

    返回值 void

  • 参数类型说明
    visibleboolean

    返回值 void

  • 参数类型说明
    zIndexnumber

    返回值 void

样式

  • 设置渐变色

    参数类型说明
    gradientobject

    返回值 Heatmap

  • 批量更新样式

    参数类型说明
    optionsHeatmapOptions
    属性类型说明
    dataany初始数据,同 Heatmap.setData 的入参
    gradient{ [stop: number]: string }渐变色,如 { 0.25: 'rgba(0,0,255,1)', 1: 'rgba(255,0,0,1)' }。 键为 [0,1] 的位置,值为 css 颜色
    idKeystring取要素 id 的字段名
    maxnumber权重归一化上界
    maxOpacitynumber最大透明度 [0,1]
    maxZoomnumber最大显示缩放等级
    minnumber权重归一化下界
    minOpacitynumber最小透明度 [0,1]
    minZoomnumber最小显示缩放等级
    opacitynumber图层级透明度 [0,1]
    referCenterPoint图层参考中心点,规避大坐标浮点抖动
    renderStageRenderStage绘制阶段,取值见 RenderStage
    sizenumber热力核半径,单位由 unit 决定
    unit"m" | "px"半径单位:'px' 屏幕像素 / 'm' 墨卡托米
    visibleboolean是否显示
    weightFieldstring权重字段名(取 properties[weightField] 作为点权重)
    zIndexnumber显示层级,小的先画

    返回值 Heatmap

  • 设置热力核半径

    参数类型说明
    radiusnumber

    返回值 Heatmap