从高德迁移与常见问题
| 常见迁移点 | 本 SDK 对应规则 |
|---|---|
| AMap 控制对象 | 使用 SukhaMap，包名 cn.sukha.mapsdk.* |
| Key | 使用Sukha Android Key，不能复用高德 Key |
| 默认坐标 | WGS84；GCJ02 必须明确配置 |
| 高德策略整数 | 只映射本文支持的策略，不直接透传 |
| 国内城市/区划码 | 不作为搜索过滤和完整地址能力提供 |
| 位置成功码 | 定位 0；搜索/路线 1000 |
| 高德示例点聚合 | 使用 ClusterOverlay；分组结果不承诺相同 |
| 导航与预览 | RouteSearch 预览与 NavigationClient 会话分开 |
地图白屏：检查 Key/签名、数据集、网络、加载错误回调、控件尺寸和生命周期。地图点偏移：先查经纬度顺序及是否重复坐标转换。定位精度不足：检查真实 accuracy、系统精确定位权限、环境及业务阈值；不要把低质量结果改写为高精度。路线无结果：确认覆盖范围及后台规划能力。连续搜索丢旧结果：同实例主动取消旧请求是既定行为。