SUKHA MAPS · DEVELOPER CENTER
Sukha 地图开发者文档
把地图、搜索、定位和导航接入你的应用。这里提供 JavaScript SDK 与 Android SDK 的接入指南、功能说明、代码示例和 API 参考。
文档核对日期：2026-10-08。JS 源码版本 0.1.0-alpha.37；Android 模块版本及核对方式见版本与交付。
本次开发版统一使用 Sukha 命名：Android 包名 cn.sukha.mapsdk、Maven 组 cn.sukha.maps，JS 包 @sukha/maps、浏览器入口 SukhaSDK。示例均按新接口编译，不提供旧名称别名。
从这里开始
| 你的目标 | 阅读入口 |
|---|---|
| 网页、H5、Vue 或 React 项目显示地图 | JavaScript 快速开始 |
| Android 应用接入地图和定位 | Android 快速开始 |
| 比较两端已经提供的能力 | 功能清单 |
| 查方法、参数、类型和回调 | JS API 参考 · Android API 参考 |
| 查看缓存导航、多语言及后台地图编辑的边界 | 当前地图产品能力 |
| 保存到本地阅读 | 下载文档 |
一次接入的基本流程
- 向平台申请对应平台的 Key，并确定可使用的数据集和能力。
- 取得匹配本次文档的 SDK 包，配置 JS 页面 Origin 或 Android 应用包名及签名。
- 先显示地图，再按需增加定位、搜索、覆盖物、路线与导航。
- 根据 SDK 的错误回调处理权限、网络、数据覆盖和定位质量问题。
- 页面或会话结束时释放地图、定位监听、服务和导航资源。
Sukha是产品名称；现有 SDK 的 Java 包名 cn.sukha.mapsdk、Maven group cn.sukha.maps、npm 包名 @sukha/maps 和浏览器全局 SukhaSDK 保持不变。接入时不要把这些标识改写成产品名称。
接入前需要知道
- 服务地址使用
https://map.sukha.cn。doc.sukha.cn只提供文档，不是地图 API 服务地址。 - 数据集决定可显示和可查询的地图范围；本文不承诺世界各地均有完整道路、建筑及地点数据。
- 默认公开坐标采用 WGS84。JS 坐标数组为
[经度, 纬度]，AndroidLatLng构造顺序为(纬度, 经度)。 - SDK 的图形绘制是在应用中添加覆盖物；后台道路、建筑、水体编辑和地图发布有独立权限与流程。
- “支持导航”不等于任何环境都能导航；需有效路线、真实定位、对应授权，以及平台要求的运行权限。
文档结构
按“概述 → 快速开始 → 开发指南 → API 参考 → 常见问题”组织。栏目结构参考高德官方 JavaScript API 指南 和 Android SDK 指南，接口、说明及示例按Sukha项目实现编写，不代表全量兼容高德 API。