基础概念与坐标
| 数据 | 顺序 / 单位 | 约定 |
|---|---|---|
| LatLng / LatLonPoint / SukhaLatLng | 纬度、经度；度 | 默认 WGS84 |
| Android Location | 原始 WGS84 | 即便地图使用 GCJ02，也不预先偏移传感器位置 |
| 路线距离 / 定位 accuracy | 米 | accuracy 越小，水平不确定性通常越小 |
| 路线 time / duration | 秒 | 不要当毫秒 |
| 定位时间戳、间隔、超时、动画时长 | 毫秒 | 时间戳使用实际采样时间 |
| 屏幕坐标、控件边距 | 物理像素 | dp 由宿主换算 |
| Android 颜色 | ARGB int | 例如 0xff1268e5 |
默认使用 WGS84，缅甸数据建议保留此模式。迁移 GCJ02 业务可在创建任何地图/服务前选择模式：
MapsInitializer.initialize(context, "https://map.sukha.cn", "YOUR_DATASET_ID",
"zh-CN", CoordinateMode.System.GCJ02);
此时地图、搜索及路线公开坐标使用 GCJ02；后台仍使用 WGS84。不要再次手动偏移返回值。模式不允许在已创建地图上切换，保存状态也不能跨模式恢复。独立实例使用 AndroidSdkClient.create(context, base, dataset, language, coordinateSystem)，在 MapView.onCreate 前 setServiceClient(client)，搜索服务共享同一 client。
转换支持算法区间为经度 73.66–135.05、纬度 3.86–53.55，区间外报错；它不是行政边界数据。手工 GeoJSON、覆盖物、聚合点应已属于选定公开坐标系。第三方栅格瓦片不会自动重投影。原始定位回调保持 WGS84；NavigationClient.toNavigationPosition(fix) 可转换为导航公开坐标。