当前地图产品能力与 SDK 边界

地图显示和数据更新

当前地图产品能够显示道路、地点、建筑和已发布水体，支持搜索、选点、路线预览和导航。实际可见范围由地图发布数据、账号授权和显示规则共同决定。某个地点可以被接口查到，不代表所有缩放级别都会显示名称。

后台编辑视图还可能包含未发布的修改、候选道路和采集记录。手机读取已发布地图与路由数据，因此“后台画出来”与“手机已经看得到”不是同一状态。SDK 地图覆盖物也不会自动写入底图数据库。

道路、建筑与水体维护

• 道路：节点选择与编辑、属性修改、删除、采集轨迹修正及候选确认。
• 建筑：轮廓绘制、采集和属性编辑，按发布流程更新底图。
• 水体：分段绘制岸线、连接临近段并形成水面；具体交互以后台编辑工具提示为准。
• 地点：标注、查看、修改和删除，由业务账号权限控制。

这些功能归属于管理后台或完整 App 流程。JS SDK 的 Polyline、Polygon、MouseTool 和编辑器用于应用内图形交互，不授予地图数据写入、审核和发布权限。

Android 导航与离线准备

当前 Android 导航服务具备路线准备、缓存、导航状态恢复及弱网处理。使用完整地图页或前台导航服务时，先联网获得有效路线并完成缓存准备，再进入离线场景。

“离线导航”在此指跟随已经准备好的路线、步骤及语音进行引导，并不等于下载整个地区后任意离线搜索和规划。离线重新规划是否可用，还取决于已缓存路网的范围和准备完成状态；未命中缓存时需要联网，不能保证任意偏航都能离线重算。

GPS 信号不足时保留导航会话并等待可靠位置，避免继续播放错误的转向指令。GPS 没有有效位置与手机没有网络是两种情况；缓存解决后者，并不能制造定位数据。

低层 NavigationClient 与 NavigationController、NavigationForegroundService 的职责不同。要使用后台和缓存能力，请阅读 Android 后台与缓存导航，不能只实例化低层控制器就认为完整服务已启用。

导航语言

Android 自带导航页与自有地图页共用布局和版权组件。昼夜外观跟随宿主 App：支持 DayNight 的宿主按其实际模式切换，固定浅色的宿主保持白天，不按日出日落或 GPS 判断。通过 Activity 上下文调用 SukhaNaviPage.createIntent 或 showRouteActivity，以继承该页面的外观策略。宿主自定义控件仍由宿主负责适配。

导航页左下角固定显示版权：中文 © 苏哈出行、英文 © Sukha Go、缅文 © သုခ，与导航界面语言一致。

Android 完整地图界面通过 SukhaMapConfig.Builder.language(...) 和 voiceLanguage(...) 配置显示与语音语言，当前有中文、英文和缅文相关资源及调用路径。前台导航服务也提供语言设置入口。实际播报仍取决于对应资源、指令内容及设备音频状态。

JS load() 支持 language 和可选 voiceLanguage，值为 zh-CN、en-US、my-MM。语音默认跟随界面语言；每个 SDK 实例独立配置。搜索、路线面板、配送组件、导航提示和录音按此配置工作。地图名称采用服务端已维护的翻译，缺少翻译时保留原名；宿主传入的订单状态与自定义文案由宿主翻译。浏览器播音仍需用户手势解锁并保持页面在前台。

商业 SDK 交付边界

SDK 按商业授权提供运行库和公开接口。Sukha 自有应用也是同一 SDK 的接入方。全量 SDK 功能授权不包含管理后台、采集审核、地图发布，以及平台订单、商户、代理或用户数据的访问权限。

客户包提供编译后的 Android AAR、压缩的 JavaScript、类型声明、接入示例和第三方许可证，不提供 SDK 实现源码、源码映射、签名密钥或生产数据库。客户端运行代码始终可能被分析，授权与私有业务必须在服务端校验。第三方组件遵循各自的许可证。

版本判断

App 版本、SDK Maven 版本、地图数据版本、路由图版本和文档日期分别管理。仅看到版本名称相同，不能证明二进制内容和地图数据相同。接入本次 SDK 接口前，应确认取得与本次文档对应的 SDK 构建；历史交付包可能缺少后续增加的方法。