坐标、单位与地图定位

理解 deck.gl 坐标、单位和局部偏移,并让数据准确覆盖到 Mapbox 地图上。

🎯 引言

学完这篇文章,你能判断位置偏移的原因,并根据地图范围选择经纬度坐标、米、像素或局部坐标。

🧱 经纬度坐标

地理点通常写成 [longitude, latitude, altitude]:经度在前,纬度在后,高度可以省略。普通的 WGS84 经纬度数据可以直接作为 getPosition 的返回值:

getPosition: (station) => [station.longitude, station.latitude],

Mapbox Camera 和 deck.gl Overlay 使用同一个地图空间,所以正常经纬度图层可以直接覆盖在 Mapbox 底图上。最常见的错误是把坐标写成 [latitude, longitude],这会让图形出现在错误位置。

⚖️ 米、像素与坐标系统

图层属性的单位要单独判断:

  • radiusUnits: 'meters':半径按地理距离计算,缩放地图时视觉大小会变化。
  • radiusUnits: 'pixels':半径按屏幕像素计算,适合保持点在屏幕上的可读大小。
  • coordinateSystem:告诉 deck.gl 如何解释位置数组。
new ScatterplotLayer({
    id: 'meter-offset',
    data: [{ position: [350, 180, 0] }],
    coordinateSystem: COORDINATE_SYSTEM.METER_OFFSETS,
    coordinateOrigin: [116.4, 39.9, 0],
    getPosition: (item) => item.position,
    getRadius: 20,
    radiusUnits: 'pixels',
});

这里的 [350, 180, 0] 不是经纬度,而是以 coordinateOrigin 为起点的米偏移。

🧭 局部坐标与数据转换

局部坐标适合在一个参考点附近表达大量相对位置,例如设备相对某个站点的偏移。大范围数据仍应使用真实经纬度或已经转换好的投影坐标。

如果数据来自 GCJ-02、BD-09、EPSG:3857 或其他本地投影,不能直接假设它是 WGS84。应先完成坐标转换,再交给 Mapbox 和 deck.gl 使用。

下面的示例把经纬度点和以同一原点计算的米偏移点放到 Mapbox 地图上:

🪤 为什么会出现位置偏移

遇到偏移时按这个顺序检查:

  1. 数组顺序是否为 [longitude, latitude]。
  2. 数据坐标系是否真的为 WGS84。
  3. 是否把米、像素或经纬度混用了。
  4. 使用 METER_OFFSETS 时,coordinateOrigin 是否和参考点一致。
  5. Mapbox 底图是否使用了不同的坐标转换或数据源。

🧾 小节总结

  • 经纬度位置通常是 [longitude, latitude, altitude]。
  • Mapbox 和 deck.gl Overlay 会共享地图空间与相机。
  • 米适合表达地理距离,像素适合保持屏幕上的视觉大小。
  • 局部坐标需要明确 coordinateSystem 和 coordinateOrigin。

❓ 知识问答

Q1:为什么 [lng, lat] 能直接覆盖 Mapbox?

因为 Mapbox 和 deck.gl Overlay 使用同一套地理地图空间,WGS84 经纬度可以被双方正确转换。

Q2:radius 和 radiusPixels 有什么区别?

它们表达的单位不同,一个按地理距离,一个按屏幕像素。具体属性名称要以图层 API 为准。

Q3:所有数据都应该使用 METER_OFFSETS 吗?

不应该。普通经纬度数据直接使用默认坐标系统即可,局部坐标只有在数据本身就是相对偏移时才使用。

🧪 小练习

  1. 把经纬度数组故意改成 [latitude, longitude],观察点如何偏移,再改回正确顺序。
  2. 把 coordinateOrigin 移动到另一个点,观察红色局部坐标点的位置变化。

🎉 现在你已经知道如何让 deck.gl 数据准确地贴合 Mapbox 地图。