功能与接口速查
先找到功能，再进入可复制的调用示例和 API 声明。本页针对当前SDK 与示例下载核对；各模块版本和校验值见版本与交付。存在公开接口不代表所有地区都有数据，搜索、地址和路线结果取决于授权及数据覆盖。
MapService、MapLocationService、MapSearchService 是接入方的封装名称，不是 Sukha SDK 的类名。 Android 原生项目应按下表映射到实际类；不要因为搜不到这三个类名就判断 SDK 不支持。
Android · Arc 弧线绘制 / MapService
已支持。 使用 SukhaMap.addArc(ArcOptions)；ArcOptions.point(起点, 经过点, 终点) 指定三个有效且不共线的点，设置颜色与线宽，返回 Arc。
复制弧线示例 · maps-core API · 通用 Android 示例 → 功能案例 → 弧线（案例 ID：arc）。
JS 没有独立 Arc 接口。 点标记、信息窗、折线、多边形和圆两端均支持，方法名存在差异；见JS 覆盖物与两端接口对照。
Android · 热力图 HeatmapTileProvider / MapService
已支持。 HeatmapTileProvider.Builder 接收坐标数据或加权数据，配置半径、透明度和渐变；通过 TileOverlayOptions.tileProvider(...) 和 SukhaMap.addTileOverlay(...) 添加到地图。更新数据后清除瓦片缓存以刷新显示。
复制热力图示例 · maps-core API · 通用 Android 示例 → 功能案例 → 热力图（heat）。
Android · 点聚合 ClusterOverlay / MapService
已支持。 ClusterItem 提供坐标，ClusterOverlay 管理聚合结果，可设置聚合点击回调、更新数据及最大聚合缩放级别。页面结束调用 destroy()。聚合格网大小按物理像素传入，不是米。
复制点聚合示例 · maps-core API · 通用 Android 示例 → 功能案例 → 点聚合（cluster）。
Android · 城市信息映射 / MapLocationService
部分支持。 SukhaLocationClient 返回 SukhaLocation，可读取经纬度、精度及可用方向、速度；启用地址请求后，通过地址回调和 getRegeocodeAddress() 获取可用地址信息。
目前不提供完整的省、市、区、行政编码映射或自动补全。 RegeocodeAddress.getCity() 等字段可能为空，不能因为存在 getter 就认定服务有完整城市数据。宿主应保留空值或提示“暂无城市信息”，不要将附近地点名填作城市名。
定位配置、地址回调 · 定位 API · 逆地理编码 API。
Android · 正地理编码 GeocodeSearch / MapSearchService
支持地点名称转坐标，范围受限。 使用 GeocodeSearch.getFromLocationNameAsyn(new GeocodeQuery("地点名称", ""))，在 onGeocodeSearched 中读取结果；同步方法 getFromLocationName 只能在工作线程调用。
当前匹配授权数据集内已发布的地点、建筑名称，不是任意街道、门牌地址的完整解析器。city 参数只传空字符串或 null；查询成功也可能无匹配结果。需要单独处理失败回调和空结果。
复制正向与逆向编码示例 · maps-services API · 通用 Android 示例 → 功能案例 → 正地理编码（forward）。
Android · 步行、骑行路线 / MapSearchService
驾车和步行已支持，独立骑行规则未提供。 步行使用 RouteSearch.WalkRouteQuery、calculateWalkRouteAsyn(...)，通过 OnRouteSearchListener.onWalkRouteSearched(...) 接收结果；同步 calculateWalkRoute(...) 仅用于工作线程。
不要将驾车路线改名为骑行，也不要把步行结果当作骑行道路规则。路线查询失败或无可达路径时，应显示失败状态。
复制驾车与步行示例 · maps-services API · 通用 Android 示例 → 功能案例 → 步行路线（walk）。
Android · 错误日志代理 SdkLogger / MapSearchService
部分支持。 cn.sukha.mapsdk.services.core.SdkLogger.setErrorLogger(...) 可桥接宿主日志系统，回调字段为 source、code、requestId；传 null 移除监听。
该入口用于经过 AsyncService.submit 的服务错误上报，不是所有内部日志、系统日志或崩溃日志的拦截器。同步参数校验异常、其他接口失败回调仍需宿主自行处理。记录错误码和请求 ID 即可，不输出 Key、令牌或不必要的精确位置。
复制日志接入示例 · SdkLogger API。日志代理示例在文档中；通用示例的错误案例用于查看服务失败反馈，不应当作全局日志采集程序。
Web · 行政区域划分 / 行政边界查询
未提供行政区查询、行政边界下载或城市编码服务。 如果业务已有授权使用的边界坐标，可使用 Polygon 绘制行政区域。这是覆盖物绘制，不代表 SDK 自带行政区数据。
Web · 公交、骑行、步行路径规划
驾车 Driving、步行 Walking 已支持；公交、骑行规划未提供。 不提供公交站点、班次和换乘计算，也没有独立骑行路网策略。
其他功能与示例入口
| 需要做什么 | 功能说明与代码 | 可运行示例 |
|---|---|---|
| 地图相机、手势、点线面和信息窗 | Android 地图 / 覆盖物 · JS 地图 / 覆盖物 | 功能案例目录 |
| 单次或连续定位、精度与权限 | Android 定位 · JS 定位 | 示例下载与在线体验 |
| POI 搜索、输入联想、逆地理编码 | Android 搜索 · JS 搜索 | 按名称查找功能案例 |
| 导航页面、语音、多语言、后台及缓存路线 | Android 导航 / 后台与缓存 · JS 导航 | 功能案例目录 |
| 配送选址与位置展示 | 地图产品能力 · JS 组件 | 配送示例下载 |
完整平台对比见功能清单。接入前先完成授权和初始化：Android 快速开始、JS 快速开始。示例工程源码供开发参考，SDK 以编译产物交付；详见授权与交付边界。
旧说明与版本差异
2026-09-21 对接说明是历史版本材料，其“Arc、热力图、点聚合、正地理编码和步行未提供”等结论已不适用于当前交付包。不要把不同日期的包、说明和示例混用；以本页、当前 API 声明及下载页对应校验值为准。本文没有承诺尚未实现的城市补全、公交或骑行能力。