时间序列与轨迹动画

在 Mapbox 地图上使用 TripsLayer 表达带时间戳的车辆、船舶或飞机轨迹。

🎯 引言

学完这篇文章,你能准备带时间戳的路径数据,用 TripsLayer 在 Mapbox 地图上显示一段带尾迹的运动轨迹。

🧱 TripsLayer 的数据结构

每条轨迹至少包含 path 和 timestamps,两个数组需要一一对应:

const trips = [{
    path: [
        [116.32, 39.87],
        [116.37, 39.89],
        [116.42, 39.91],
        [116.48, 39.95],
    ],
    timestamps: [0, 10, 20, 30],
}];

path 是经纬度坐标序列,timestamps 表示每个位置对应的时间刻度。时间刻度不必直接使用真实日期,但必须保持可比较的顺序。

🛠 创建轨迹图层

const layer = new TripsLayer({
    id: 'vehicle-trips',
    data: trips,
    getPath: (trip) => trip.path,
    getTimestamps: (trip) => trip.timestamps,
    currentTime: 20,
    trailLength: 12,
    getColor: [16, 185, 129],
    widthMinPixels: 5,
});

overlay.setProps({ layers: [layer] });

currentTime 决定当前播放位置,trailLength 决定保留多长的尾迹。Mapbox 继续负责城市道路和相机,TripsLayer 只负责轨迹表达。

在 Mapbox 底图上,持续更新 TripsLayer 的时间即可显示运动轨迹:

▶️ 播放、暂停与时间窗口

动画的核心是改变 currentTime 并重新设置 Overlay 图层:

let currentTime = 0;

function updateAnimation() {
    currentTime += 0.25;
    overlay.setProps({
        layers: [new TripsLayer({
            id: 'vehicle-trips',
            data: trips,
            getPath: (trip) => trip.path,
            getTimestamps: (trip) => trip.timestamps,
            currentTime,
            trailLength: 12,
        })],
    });
}

实际项目中,播放按钮、时间轴和速度选择由页面状态管理;离开页面时要取消 requestAnimationFrame,避免继续更新已经卸载的 Overlay。

🪤 时间数据的常见问题

  • path 和 timestamps 长度不一致,会导致轨迹和时间错位。
  • 时间刻度跨度过大或过小,会让播放速度难以控制。
  • 轨迹坐标不是 WGS84 时,需要先完成坐标转换。
  • trailLength 过长会让不同轨迹难以区分,应结合播放速度调整。

🧾 小节总结

  • TripsLayer 用路径和时间戳表达运动轨迹。
  • currentTime 控制播放位置,trailLength 控制尾迹长度。
  • 动画只更新 deck.gl 图层,不需要重建 Mapbox 地图。
  • 播放控制由页面状态管理,组件卸载时取消动画帧。

❓ 知识问答

Q1:timestamps 必须是日期字符串吗?

不必须。只要是可比较的数值时间刻度即可,真实日期可以先转换成相对秒数。

Q2:为什么轨迹不动?

检查是否持续改变 currentTime,以及 path 和 timestamps 是否正确对应。

Q3:地图缩放会影响轨迹动画吗?

不会改变动画时间。Mapbox Camera 变化只会改变观察范围,TripsLayer 仍然使用自己的时间刻度。

🧪 小练习

  1. 把 trailLength 改成 5,观察尾迹变短后的效果。
  2. 给 trips 增加第二条路线,并使用另一种颜色。

🎉 现在你可以在地图上表达带时间变化的空间轨迹了。