FlyLineLayer

飞线可视化图层,在地图上批量绘制抬升的流动弧线,适合 OD(起讫点)关系展示。

几何类型支持 LineString / MultiLineString(一条 OD 即一条两点的 LineString)。 曲线形态由 mode 决定:'arc' 首末两点成弧、'path' 沿原始折线抬升,见 FlyLineLayerOptions。

构造函数

  • 创建飞线图层

    参数类型说明
    options 可选FlyLineLayerOptions配置项
    属性类型说明
    animationboolean是否流动,false 退化成静态弧线层
    arcHeightnumber弧顶高度占首末点直线距离的比例,0 即贴地不抬升
    baseOpacitynumber底线常显透明度,0 则只见流动亮点、整条弧不可见
    blend"default" | "lighter"混合模式:'lighter' 为加性混合,只在深色底图上有意义
    curvaturenumber水平弯曲程度(控制点沿垂线偏移占直线距离的比例),0 即不弯。仅 mode: 'arc' 生效
    dataany初始数据,同 FlyLineLayer.setData 的入参
    durationnumber一圈秒数
    idKeystring取要素 id 的字段名
    intervalnumber粒子间距占全线比例,粒子数 = 1 / interval;取 1 即单个彗星
    maxZoomnumber最大显示缩放等级
    minZoomnumber最小显示缩放等级
    mode"arc" | "path"曲线形态:'arc' 只取首末两点生成弧线(忽略中间点);'path' 原样使用所有点、只叠加高度
    opacitynumber图层级透明度 [0,1]
    randomPhaseboolean每条线是否随机相位,false 则所有线齐步走
    referCenterPoint图层参考中心点,规避大坐标浮点抖动
    renderStageRenderStage绘制阶段,取值见 RenderStage
    segmentsnumber每条弧的采样段数。仅 mode: 'arc' 生效
    strokeColorstring线颜色,css 字符串
    strokeLineCap"round" | "butt" | "square"线端点样式
    strokeLineJoin"round" | "miter" | "bevel"拐角连接样式
    strokeOpacitynumber线透明度 [0,1],与线色 alpha、图层级 opacity 相乘
    strokeWeightnumber线宽(屏幕 px,全宽)
    trailLengthnumber拖尾长度占间隔的比例
    visibleboolean是否显示
    zIndexnumber显示层级,小的先画

    返回值 FlyLineLayer

    示例代码1

    const layer = new BMap.FlyLineLayer({ strokeColor: 'rgba(255, 71, 26, 0.9)', arcHeight: 0.2 });
    layer.setData({
    type: 'FeatureCollection',
    features: [
    { type: 'Feature', geometry: { type: 'LineString', coordinates: [[116.40, 39.91], [117.20, 39.13]] }, properties: {} }
    ]
    });
    map.addLayer(layer);

数据

  • 返回原始数据

    返回值 any

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

    参数类型说明
    geojsonany

    返回值 FlyLineLayer

显示属性

  • 返回值 number

  • 返回值 "building" | "poi"

  • 返回值 boolean

  • 返回值 number

  • 参数类型说明
    opacitynumber

    返回值 void

  • 参数类型说明
    centerPoint

    返回值 void

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

    返回值 void

  • 参数类型说明
    visibleboolean

    返回值 void

  • 参数类型说明
    zIndexnumber

    返回值 void

样式

  • 批量更新样式

    参数类型说明
    optionsFlyLineLayerOptions
    属性类型说明
    animationboolean是否流动,false 退化成静态弧线层
    arcHeightnumber弧顶高度占首末点直线距离的比例,0 即贴地不抬升
    baseOpacitynumber底线常显透明度,0 则只见流动亮点、整条弧不可见
    blend"default" | "lighter"混合模式:'lighter' 为加性混合,只在深色底图上有意义
    curvaturenumber水平弯曲程度(控制点沿垂线偏移占直线距离的比例),0 即不弯。仅 mode: 'arc' 生效
    dataany初始数据,同 FlyLineLayer.setData 的入参
    durationnumber一圈秒数
    idKeystring取要素 id 的字段名
    intervalnumber粒子间距占全线比例,粒子数 = 1 / interval;取 1 即单个彗星
    maxZoomnumber最大显示缩放等级
    minZoomnumber最小显示缩放等级
    mode"arc" | "path"曲线形态:'arc' 只取首末两点生成弧线(忽略中间点);'path' 原样使用所有点、只叠加高度
    opacitynumber图层级透明度 [0,1]
    randomPhaseboolean每条线是否随机相位,false 则所有线齐步走
    referCenterPoint图层参考中心点,规避大坐标浮点抖动
    renderStageRenderStage绘制阶段,取值见 RenderStage
    segmentsnumber每条弧的采样段数。仅 mode: 'arc' 生效
    strokeColorstring线颜色,css 字符串
    strokeLineCap"round" | "butt" | "square"线端点样式
    strokeLineJoin"round" | "miter" | "bevel"拐角连接样式
    strokeOpacitynumber线透明度 [0,1],与线色 alpha、图层级 opacity 相乘
    strokeWeightnumber线宽(屏幕 px,全宽)
    trailLengthnumber拖尾长度占间隔的比例
    visibleboolean是否显示
    zIndexnumber显示层级,小的先画

    返回值 FlyLineLayer