S苏哈出行开发者文档

商用接入验收

本批交付用于客户接入和现场验收。自动化验证不替代真实卫星信号、手机厂商后台策略和道路播报验收。上线前使用客户自己的 Key、签名和域名,完成下表中的现场项目。

平台能力

场景 Android SDK JavaScript SDK
已确认路线断网后继续 默认导航服务持有路线与本地语音,可继续引导 页面存活且语音准备为 ready 时,可沿原路线继续前台引导
离线偏航重算 依赖相应离线路网已下载及覆盖范围 当前不支持,需要联网
弱 GPS 或位置停止更新 暂停不可靠指引,等待准确位置恢复 暂停不可靠播报,恢复后继续
锁屏、退到后台 使用 SDK 前台导航服务及常驻通知;仍需厂商设备验证 浏览器可能暂停定位与音频,不承诺连续后台导航
新区域地图与地点搜索 受授权、缓存范围和网络状态限制 受授权、缓存范围和网络状态限制
断网与授权 临时断网不等于授权拒绝;缓存有时效,恢复网络后重新验证 正式域名需要独立授权;已准备页面不等于永久离线许可证

Android 接入步骤见后台导航与缓存。JS 语音预缓存、准备状态和限制见导航指南。地图、路线、语音和离线路网是不同资源,不应把其中一项准备完成显示为“全地图离线就绪”。

自动化与现场验收

本轮自动化覆盖独立应用授权、Android 导航及定位单元回归、JS 语音预缓存与导航恢复;Android 模拟器还检查断网启动已规划路线、弱定位恢复、锁屏后台跨越短期授权续期及恢复联网。实际通过结果随发布验证记录核对。

客户正式上线前应完成:

  1. 使用正式包名、发布证书或实际 HTTPS Origin 验证独立 Key;错误签名、错误域名、过期或停用授权应得到明确拒绝。
  2. 真实手机连续导航至少 30 分钟,记录定位精度、转向播报、到达、发热和耗电。
  3. 出发前完成路线及相应缓存准备,断网后沿线行驶,再测试恢复联网;另行确认偏航位置是否在已缓存路网内。
  4. 建筑旁或弱信号区域驶回开阔路段,确认不会使用旧位置继续报转弯,且恢复后无需重开导航。
  5. HOME、锁屏至少 5 分钟再回到页面,确认服务通知、定位与播报继续,结束导航后停止定位。

记录手机型号、系统、APK/SDK 版本、测试时段、预期与实际结果。现场操作由乘客进行;分享日志前去除 Key、令牌及非必要个人信息。真实道路与不同厂商后台行为仍需现场验收,未将模拟器测试标为实车通过。

客户交付边界

下载包提供 SDK 编译制品、公开接口声明、审核过的示例源码和许可证,不提供 SDK 原始实现工程、服务端业务源码、签名私钥或生产数据。浏览器代码和客户端二进制仍可被分析;关键授权与商业机密必须留在服务端。详见授权与交付边界。