Leaflet 对接高德或天地图底图
Leaflet 对接高德或天地图底图,可直接用稳定版 1.9.4 的 L.tileLayer 加载对应瓦片服务:高德提供无需 Key 的 XYZ 矢量与影像地址,天地图则走官方 WMTS 并强制携带 tk 参数。两者默认都兼容 Leaflet 的 EPSG:3857,但高德是 GCJ-02 火星坐标,叠加自有 WGS84 数据会出现几十到几百米偏移,需额外纠偏;天地图 CGCS2000 与 WGS84 差异亚米级,兼容性更好。生产环境优先选 1.9.4,截至 2026 年 11 月 Leaflet 2.0 仍处 beta,插件兼容性需自行验证。

对接前要先解决什么问题
动手前先明确三件事:底图只是背景瓦片,不负责坐标转换;高德与天地图的服务条款和配额不同;Leaflet 默认 CRS 是 Web 墨卡托,换投影或换底图时覆盖物位置会跳。验收标准很简单——地图能流畅拖到 18 级、注记不糊、自有点线与底图对齐误差控制在可接受范围。
- 准备 Leaflet 1.9.4(CDN、npm 或本地 ZIP 均可)
- 高德裸瓦片可直接测,天地图必须先申请 Key
- 决定是否叠加注记层,以及是否用插件封装
怎么用原生方式对接高德底图
高德矢量(带注记)和影像都是标准 XYZ,社区长期使用的地址如下,无需 Key 即可加载,适合快速原型。商用场景建议走正式授权,避免后期限流。
- 引入 Leaflet CSS 与 JS 后,创建 map:L.map(‘map’, {center: [39.9, 116.4], zoom: 12}),保持默认 CRS。
- 矢量底图:L.tileLayer(‘https://webrd0{s}.is.autonavi.com/appmaptile?lang=zh_cn&size=1&scale=1&style=8&x={x}&y={y}&z={z}’, {subdomains: ‘1234’, maxZoom: 18, attribution: ‘© 高德地图’}).addTo(map)。
- 影像底图把 style 换成 6,地址换成 webst0{s};需要注记时再叠一层 style=8 的注记瓦片,用 LayerGroup 管理。
- 打开浏览器网络面板,确认 256×256 瓦片 200 返回,拖动无空白即通过。
更多原始 URL 变体与示例可在 leaflet-tileLayer-baidugaode 仓库 查看。
怎么对接天地图底图
天地图走 OGC WMTS,必须带 tk。先到官网控制台申请浏览器端 Key(个人每日约 1 万次配额,以官网最新说明为准),再拼 URL。
- 申请 Key 并实名,创建应用后复制 tk。
- 矢量墨卡托(_w):L.tileLayer(‘https://t{s}.tianditu.gov.cn/vec_w/wmts?SERVICE=WMTS&REQUEST=GetTile&VERSION=1.0.0&LAYER=vec&STYLE=default&TILEMATRIXSET=w&FORMAT=tiles&TILEMATRIX={z}&TILEROW={y}&TILECOL={x}&tk=你的Key’, {subdomains: [‘0′,’1′,’2′,’3′,’4′,’5′,’6′,’7’], maxZoom: 18}).addTo(map)。
- 注记层把 LAYER 换成 cva;影像用 img + cia。经纬度投影(_c)需显式设置 map 的 crs 为 L.CRS.EPSG4326,并注意 zoomOffset。
- 用 LayerGroup 把底图与注记一起加进图层控件,方便切换。
若不想手写长 URL,可用插件封装。

坐标系偏移怎么处理,插件怎么选
高德是 GCJ-02,Leaflet 默认按 WGS84/EPSG:3857 摆瓦片,直接叠 GPS 或测绘数据会偏。天地图 ≈WGS84,偏移通常可忽略。两种常见解法:
- 数据侧:把覆盖物坐标统一转成 GCJ-02 再上图。
- 渲染侧:加载纠偏插件,让瓦片整体对齐到 WGS84。
推荐插件 Leaflet.ChineseTmsProviders:一行代码即可切高德 Normal/Satellite 或天地图 Normal/Satellite/Terrain,内部已处理好 subdomains 与 attribution。纠偏可配合 Leaflet.InternetMapCorrection。两者均面向 Leaflet 1.9.x,2.0 beta 需单独测试。
| 对比项 | 高德裸瓦片 | 天地图 WMTS | ChineseTmsProviders 插件 |
|---|---|---|---|
| 是否需要 Key | 通常否 | 是(tk) | 高德可选,天地图必填 |
| 坐标系 | GCJ-02 | CGCS2000≈WGS84 | 同上,按 provider 决定 |
| 接入复杂度 | 低(直接 URL) | 中(拼 WMTS) | 最低(一行调用) |
| 商用注意 | 建议正式授权 | 免费有配额 | 跟随底层服务条款 |
常见问题
瓦片一片空白或 401?
检查 subdomains 是否写成数组或字符串、HTTPS 是否通、天地图 tk 是否正确且未超配额;高德 style 参数写错也会返回空图。打开开发者工具看实际请求 URL 是否与文档一致。
切换底图后点线整体偏移?
高德与天地图坐标系不同,覆盖物坐标系没统一。要么全部转 GCJ-02,要么加载纠偏插件只纠正瓦片位置,数据保持 WGS84。
Leaflet 2.0 beta 能直接用这些插件吗?
截至 2026 年 11 月,主流中国底图插件仍以 1.9.x 为目标。2.0 改用纯 ES class 且 tree-shakeable,建议生产继续锁 1.9.4,beta 环境单独建分支验证。
商用会不会被封?
高德裸瓦片社区可用,但正式商用需申请授权并保留 attribution;天地图个人配额够用,企业场景关注每日上限并做域名白名单。离线缓存需遵守测绘与版权规定。
总结:先用原生 tileLayer 跑通高德矢量或天地图 vec_w,确认缩放与网络正常;有偏移就上纠偏插件,需要快速切换就上 ChineseTmsProviders。生产锁定 Leaflet 1.9.4,Key 与授权以各自官网控制台最新规则为准,保留 attribution 并做好配额监控。