企业官网建设流程全解析

前言

刚开始用地图 SDK，很多人会遇到一个奇怪的问题：GPS 获取到的当前位置，标到地图上发现偏了几百米甚至一两公里——明明站在马路上，标记却在马路旁边的小区里。

这不是 bug，这是坐标系的问题。中国有专属的地图坐标系 GCJ02，GPS 用的是 WGS84，两者之间存在系统性偏移。这篇文章把这个问题讲清楚，然后看项目里是怎么处理的。

项目预览

一、三种坐标系

1.1 WGS84（全球通用）

World Geodetic System 1984，国际标准坐标系，GPS 卫星使用的就是这套坐标。geoLocationManager.getCurrentLocation()返回的位置就是 WGS84 坐标。

1.2 GCJ02（中国国标）

国测局02坐标系，也叫"火星坐标系"，是中国政府要求在中国境内地图必须使用的坐标系。高德地图、腾讯地图、华为 MapKit 在中国显示地图时都用 GCJ02。

WGS84 → GCJ02 的转换算法叫"火星偏移"，偏移量在 100-300 米之间，随地理位置变化。

1.3 BD09（百度专用）

百度地图在 GCJ02 基础上又加了一层偏移，得到 BD09。只有百度地图使用，其他地图不认。

1.4 三者对比

二、为什么偏移这么大？

GCJ02 的偏移是故意的（保密级测绘数据保护），且偏移量不是简单的固定值，而是根据经纬度变化的非线性偏移，无法通过简单加减得到原始坐标（除非你知道转换算法）。

正确做法：

• 用geoLocationManager获取到 WGS84 坐标
• 显示到地图上之前，转换为 GCJ02
• 地图上的操作（标记、路线）统一用 GCJ02

三、项目中的坐标转换

// entry/src/main/ets/utils/MapUtil.etspublicasyncconvertToGCJ02(latitude:number,longitude:number):Promise<mapCommon.LatLng>{lettheWGS84Position:mapCommon.LatLng={latitude:latitude,longitude:longitude};// MapKit 提供的官方转换 APIlettheGCJ02Position:mapCommon.LatLng=awaitmap.convertCoordinate(mapCommon.CoordinateType.WGS84,// 源坐标系：WGS84mapCommon.CoordinateType.GCJ02,// 目标坐标系：GCJ02theWGS84Position);returntheGCJ02Position;}

map.convertCoordinate是 MapKit 提供的官方坐标转换 API，支持：

四、转换在哪里被调用？

// MapUtil.etsasyncmoveToMyLocation(mapController:map.MapComponentController):Promise<void>{// 1. 获取 GPS 位置（WGS84 坐标）letlocation:geoLocationManager.Location=awaitthis.getMyLocation();// 2. 更新地图的"我的位置"mapController?.setMyLocation(location);// 注意：这里传的是 WGS84（地图内部处理）// 3. 移动镜头前，先转换为 GCJ02letgcj02Position=awaitthis.convertToGCJ02(location.latitude,location.longitude);// 4. 用 GCJ02 坐标移动镜头this.moveToCurrentPosition(gcj02Position.latitude,gcj02Position.longitude,mapController);}

流程：

1. geoLocationManager.getCurrentLocation()获取 WGS84 位置
2. setMyLocation(location)设置地图上显示的用户位置（SDK 内部会处理转换）
3. convertToGCJ02()手动转换坐标
4. moveToCurrentPosition()用 GCJ02 坐标移动地图镜头

提示：setMyLocation接受的是 WGS84 位置，SDK 内部自动转换；而moveToCurrentPosition（animateCamera）期望的是 GCJ02，所以需要手动转换后传入。这是一个容易搞混的地方。

五、加油站标记为什么不用转换？

// 加油站数据（StationData.ets）'latitude':31.937176963332842,'longitude':118.86018812656404,

加油站的坐标是手动配置的，注释里说// Please configure it yourself——这些坐标应该直接填入 GCJ02 坐标（从高德、腾讯地图上取点，那些平台给的就是 GCJ02）。

// 添加标记时直接用（假设数据里就是 GCJ02）asyncaddMapMaker(latitude:number,longitude:number,mapController:...):Promise<void>{letmarkerOptions:mapCommon.MarkerOptions={position:{latitude:latitude,// 直接用，不转换longitude:longitude},// ...};awaitmapController.addMarker(markerOptions);}

结论：地图 API（animateCamera、addMarker）统一使用 GCJ02，只有 GPS 获取到的位置是 WGS84，需要转换。

六、常见踩坑

踩坑 1：标记位置偏移

症状：在地图上点了一个位置，记录下经纬度，再次标记发现偏了。

原因：混用了坐标系。地图上点击返回的是 GCJ02，但存储时以为是 WGS84，再次标记时又转换了一次，偏了两次。

方法：统一约定"地图相关操作全部用 GCJ02，GPS 获取的才需要转换"。

踩坑 2：convertCoordinate 是异步的

// 错误：同步调用，结果可能不正确letgcj02=map.convertCoordinate(WGS84,GCJ02,position);// 返回 Promise，不是结果// 正确：等待 Promiseletgcj02=awaitmap.convertCoordinate(WGS84,GCJ02,position);

提示：注释里也提到了// the synchronous conversion method here may cause errors——不要尝试同步调用，必须await。

踩坑 3：中国境外不需要转换

GCJ02 偏移只在中国境内地图有效（境外地图和 WGS84 一致）。如果你的应用支持全球定位，需要判断用户是否在中国境内再决定是否转换。

七、可视化理解

想象这样的场景：

真实位置（WGS84）：公司大楼门口 [31.9370, 118.8600] ↓ 偏移约200米 GCJ02地图上： 小区内部 [31.9372, 118.8618]（大约）

所以用 GPS 坐标直接标在 GCJ02 地图上，你的标记会"飞"到几百米外的地方。转换后才能准确落在实际位置。

总结

坐标系问题是所有在中国做地图应用的开发者必过的坎：

1. GPS / geoLocationManager→ WGS84 坐标
2. 中国地图（高德、腾讯、华为MapKit）→ GCJ02 坐标
3. 两者之间有 100-300 米的系统性偏移，不转换会导致标记偏位
4. 使用map.convertCoordinate(WGS84, GCJ02, position)转换，记得await
5. 手动配置的加油站坐标应直接使用 GCJ02，不需要转换

下一篇讲Marker 地图标记——怎么给地图上每个加油站加一个自定义图标，点击标记还有弹窗和动画。