不依赖任何第三方地图 Key。瓦片、搜索、逆地理编码、距离计算全部由本机提供。
// H5 / Web:引入 SDK(无需 npm install)
<script src="http://你的服务器:8130/sdk/dsh-map.js"></script>
<script>
var map = DSHMap.create({ base: 'http://你的服务器:8130' });
// 坐标 → 地址(离线)
map.regeo(31.2304, 121.4737).then(r => console.log(r.formatted.address));
// 地址 → 坐标
map.search('上海外滩').then(r => console.log(r.results[0]));
// 距离
map.distance({lat:31.23,lon:121.47}, {lat:39.9,lon:116.39})
.then(r => console.log(r.results[0].km + ' km'));
</script>
| 接口 | 说明 | 是否联网 |
|---|---|---|
/api/regeo | 坐标 → 地址(行政区划) | 纯离线 |
/api/admin | 坐标 → 行政区划 + adcode | 纯离线 |
/api/suggest | 输入联想 | 纯离线 |
/api/search | 地名 / POI 搜索 | 离线优先,在线兜底 |
/api/distance | 距离计算(支持一对多) | 纯离线 |
/api/convert | WGS-84 / GCJ-02 / BD-09 互转 | 纯离线 |
/tile/{layer}/{z}/{x}/{y}.png | 地图瓦片(代理 + 缓存) | 代理上游 |
/api/status | 健康状态与能力清单 | 纯离线 |
本服务是自托管的。第三方地图商的调用全部发生在本机服务端,客户端只见你自己的域名 ——
这正是它能同时服务 H5、小程序、App 而不必各自申请 Key 的原因。
详细的部署、多端接入与已知限制见项目目录下的 README.md。