经纬志
首页 / Cesium / 使用示例

加载 GPX 轨迹

用 GpxDataSource 解析轨迹与航点,把户外运动数据直接放到地球上。

CesiumJS 1.121 · 更新 2026-10-28
源码与运行效果
运行效果

GPX 里有什么

trk 是轨迹,trkpt 是轨迹点,wpt 是独立航点。Cesium 把轨迹连成折线,把航点变成点或广告牌。

高度与贴地

ele 是海拔。加载时如果不要求贴地,轨迹按 ele 悬空;设为贴地则由地形重新决定高度,两者视觉差别在山区最明显。

GPX 元素生成实体说明
trk/trksegpolyline一段轨迹一条线
trkpt顶点含 lat / lon / ele
wptpoint / billboard独立航点

GPX 的时间字段是可选的,缺少时间时轨迹不会有时间动画,只能作为静态线显示。