S苏哈出行开发者文档

已发布与待发布功能

核对日期:2026-10-14。公开下载页当前提供 JavaScript 0.1.0-alpha.44。各 Android 模块单独编号,完整版本和交付包 SHA256 见版本与交付。SDK 软件版本、地图数据版本和文档日期分别管理。

本次核对结果

功能 / 配置 当前线上与公开交付包 新实现及使用条件
客户 JS 通用及配送案例数据集 显式指定 shan,授权图源为 shan 客户替换为自己的 Key,并确认其授权包含 shan
Android 三点弧线 已有 Arc / ArcOptions / addArc Android 覆盖物
JavaScript 三点弧线 alpha.44 已提供 sdk.Arc alpha.44 首次发布;接入与参数
本应用授权及额度查询 alpha.44 已提供 getAuthorization(),配套服务已部署 alpha.44 首次发布;字段、调用与错误
建筑图层旧式过滤修复 alpha.44 已修复并验证 alpha.44 首次修复;建筑显示采用图层缩放限制
骑行业务 用步行路线及步行导航代替 JS Walking / WalkingNavi;Android 步行 RouteSearch / WalkingNavi;规则和时间仍为步行估算
行政区查询、行政边界、完整城市编码 未提供 可用 Polygon 绘制业务自行提供的合法边界;不能据地址字段 getter 推定有行政数据
公交换乘、独立骑行规则 未提供 不以步行或驾车能力冒充独立支持

版本与配置排查

  1. 在下载页核对文件名、SDK 版本和 SHA256;检查交付包 versions.json,不要只看文档更新日期。
  2. JS version 参数用于校验已加载的代码,不能自动升级 alpha.43 到 alpha.44。升级需要替换 browser 资源或 npm 文件。
  3. 案例当前显式设置 datasetId: 'shan'。SDK 省略该参数时的兼容默认值仍是 town;这不代表所有 Key 都允许 town,也不代表源码案例可以省略配置。
  4. 数据范围由 Key 的实际绑定和服务端发布版本决定。datasetId、服务端实际 sourceDatasetId、固定或跟随当前的数据版本需要分别核对;仅改页面名称或地图中心不会改变授权范围。
  5. alpha.44 可用 getAuthorization() 查询本应用额度、有效期及能力;alpha.43 需升级后使用。未提供的 QPS / 每日请求额度不能填 0 或推算成已支持字段。

当前接口参考从下载页对应的已发布包提取;Arc 和授权查询最低需要 alpha.44,不能直接用于 alpha.43。上线前仍需使用客户自己的授权、设备和真实路线完成接入验收。