时间序列与轨迹动画
在 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 仍然使用自己的时间刻度。
🧪 小练习
- 把
trailLength改成5,观察尾迹变短后的效果。 - 给
trips增加第二条路线,并使用另一种颜色。
🎉 现在你可以在地图上表达带时间变化的空间轨迹了。
