BarLayer

三维柱状图可视化图层,在每个数据点上竖起一根多棱柱,适合展示分布量。

一根柱子可按 value 数组分成多段堆叠,每段单独的高度与颜色,用来表达 「一个位置上的多类别量」。几何类型支持 Point / MultiPoint。

构造函数

  • 创建柱状图图层

    参数类型说明
    options 可选BarLayerOptions配置项
    属性类型说明
    colorBarSegmentValue<string>柱体颜色,css 字符串。数组按分段取色,回调按分段求值
    dataany初始数据,同 BarLayer.setData 的入参
    edgeCountnumber棱数,调大(如 50)趋近圆柱
    heightBarSegmentValue<number>柱体高度。number 作为总高按各段量值占比分配;number[] 逐段绝对高;回调按分段求值
    idKeystring取要素 id 的字段名
    maxZoomnumber最大显示缩放等级
    minZoomnumber最小显示缩放等级
    opacitynumber图层级透明度 [0,1]
    referCenterPoint图层参考中心点,规避大坐标浮点抖动
    renderStageRenderStage绘制阶段,取值见 RenderStage
    sizenumber柱体半径基准,单位由 unit 决定
    unit"m" | "px"尺寸单位:'m' 墨卡托米(物理尺寸不随缩放变)/ 'px' 屏幕像素(随缩放变)
    visibleboolean是否显示
    zIndexnumber显示层级,小的先画

    返回值 BarLayer

    示例代码1

    const layer = new BMap.BarLayer({
    color: 'rgba(0, 180, 0, 1)',
    size: 50000,
    height: 100000,
    referCenter: new BMap.Point(116.404, 39.915)
    });
    layer.setData({
    type: 'FeatureCollection',
    features: [
    { type: 'Feature', geometry: { type: 'Point', coordinates: [116.404, 39.915] }, properties: { value: [3, 5, 2] } }
    ]
    });
    map.addLayer(layer);

数据

  • 返回原始数据

    返回值 any

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

    参数类型说明
    geojsonany

    返回值 BarLayer

显示属性

  • 返回值 number

  • 返回值 "building" | "poi"

  • 返回值 boolean

  • 返回值 number

  • 参数类型说明
    opacitynumber

    返回值 void

  • 参数类型说明
    centerPoint

    返回值 void

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

    返回值 void

  • 参数类型说明
    visibleboolean

    返回值 void

  • 参数类型说明
    zIndexnumber

    返回值 void

样式

  • 批量更新样式。仅更新已声明的样式键;opacity / visible / zIndex / renderStage / referCenter 转发到对应 setter,其余未知键忽略并告警一次

    参数类型说明
    optionsBarLayerOptions
    属性类型说明
    colorBarSegmentValue<string>柱体颜色,css 字符串。数组按分段取色,回调按分段求值
    dataany初始数据,同 BarLayer.setData 的入参
    edgeCountnumber棱数,调大(如 50)趋近圆柱
    heightBarSegmentValue<number>柱体高度。number 作为总高按各段量值占比分配;number[] 逐段绝对高;回调按分段求值
    idKeystring取要素 id 的字段名
    maxZoomnumber最大显示缩放等级
    minZoomnumber最小显示缩放等级
    opacitynumber图层级透明度 [0,1]
    referCenterPoint图层参考中心点,规避大坐标浮点抖动
    renderStageRenderStage绘制阶段,取值见 RenderStage
    sizenumber柱体半径基准,单位由 unit 决定
    unit"m" | "px"尺寸单位:'m' 墨卡托米(物理尺寸不随缩放变)/ 'px' 屏幕像素(随缩放变)
    visibleboolean是否显示
    zIndexnumber显示层级,小的先画

    返回值 BarLayer