坐标、单位与地图定位
🎯 引言
学完这篇文章,你能判断位置偏移的原因,并根据地图范围选择经纬度坐标、米、像素或局部坐标。
🧱 经纬度坐标
地理点通常写成 [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 地图上:
🪤 为什么会出现位置偏移
遇到偏移时按这个顺序检查:
- 数组顺序是否为
[longitude, latitude]。 - 数据坐标系是否真的为 WGS84。
- 是否把米、像素或经纬度混用了。
- 使用
METER_OFFSETS时,coordinateOrigin是否和参考点一致。 - 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 吗?
不应该。普通经纬度数据直接使用默认坐标系统即可,局部坐标只有在数据本身就是相对偏移时才使用。
🧪 小练习
- 把经纬度数组故意改成
[latitude, longitude],观察点如何偏移,再改回正确顺序。 - 把
coordinateOrigin移动到另一个点,观察红色局部坐标点的位置变化。
🎉 现在你已经知道如何让 deck.gl 数据准确地贴合 Mapbox 地图。
