1. 天地图与WMTS服务基础认知
天地图作为国内权威的在线地图服务，其WMTS（Web Map Tile Service）接口是GIS领域标准的瓦片地图服务协议。简单来说，WMTS就像乐高积木的说明书，告诉GIS软件如何获取和拼接地图瓦片。在实际项目中，我经常遇到新手把WMTS和WMS搞混的情况——前者是固定大小的图片瓦片，后者是动态生成的单张地图，这个区别直接影响加载性能。
天地图WMTS服务有几个关键特性需要注意：
- DPI参数：必须设置为96，这是天地图瓦片设计的基准分辨率。去年有个项目因为漏了这个参数，导致所有标注都偏移了200多米
- Token机制：相当于地图服务的"门票"，申请时行业类型要选"其他"，实测选其他类别成功率更高
- 多域名支持：t0~t7多个服务节点，当t0不稳定时可以尝试切换
2. 环境准备与Token申请
2.1 注册开发者账号
首先打开天地图官网的开发者平台，点击注册按钮。这里有个小技巧：建议使用企业邮箱注册，个人邮箱有时会遇到审核延迟。注册完成后别急着申请Token，先花10分钟阅读开发者协议，去年就有团队因为没注意使用条款导致服务被停用。
2.2 申请服务Token
在控制台创建应用时，关键配置如下：
- 应用类型：服务端
- 行业类别：其他
- IP白名单：建议先设置为0.0.0.0/0测试，上线前再限制
拿到Token后，建议立即做个可用性测试。在浏览器打开这个测试URL（替换your_token为实际Token）：
https://t0.tianditu.gov.cn/vec_c/wmts?service=wmts&request=GetCapabilities&tk=your_token&DPI=96如果返回XML格式的能力文档，说明Token生效。我遇到过返回418错误的情况，通常是IP被临时限制，换个网络环境就好。
3. 二维地图加载实战
3.1 MapWorld专用接口
超图为天地图定制了MapWorld连接方式，操作步骤如下：
- 在iDesktop点击"地图"→"添加WMTS地图"
- 连接类型选择"MapWorld"
- 参数配置参考：
- 服务地址：https://t0.tianditu.gov.cn
- Token：粘贴申请的密钥
- 地图类型：vec_c（矢量）、img_c（影像）
实测发现，MapWorld方式比标准WMTS连接速度快30%左右，特别是在加载省级范围数据时更明显。
3.2 标准WMTS连接
如果想用通用WMTS接口，配置时要注意：
- 服务类型选WMTS
- 获取方式选KVP
- 能力文档URL填写完整路径（含DPI参数）
- 图层名称根据需求选择：
- 矢量底图：vec
- 影像底图：img
- 注记图层：cia
这里有个坑：天地图WMTS的坐标系是EPSG:4490，不是常见的3857。有次项目忘记设置坐标系，导致叠加的业务数据全部错位。
4. 三维场景集成技巧
4.1 球面场景配置
在iDesktopX中加载三维天地图时，推荐使用OGC方式：
- 右键场景→添加三维瓦片图层
- 服务类型选WMTS
- URL中必须包含DPI=96参数
- 瓦片格式选png（影像）或png8（矢量）
三维加载有个特殊现象：在球面场景边缘会出现接缝。这不是bug，而是球面投影的自然现象。可以通过调整LOD级别来减轻，建议设置为10-15级。
4.2 性能优化方案
当加载大范围三维场景时，可以采取这些优化措施：
- 预加载半径设为2-3级
- 开启内存缓存
- 使用本地代理服务（需备案）
- 矢量图层禁用抗锯齿
去年做智慧城市项目时，通过这组优化将加载时间从47秒降到了8秒。
5. 故障排查手册
5.1 常见错误代码
- 418错误：Token无效或IP被封禁 解决方案：更换Token或网络环境
- 500错误：服务端异常 解决方案：尝试t1-t7其他服务节点
- 空白地图：缓存冲突 解决方案：清除%InstallPath%\Bin\Cache\WebCache目录
5.2 网络诊断技巧
如果遇到加载失败，可以按这个顺序排查：
- ping t0.tianditu.gov.cn 检查基础连通性
- telnet t0.tianditu.gov.cn 443 测试端口
- 用curl获取能力文档：
curl -X GET "https://t0.tianditu.gov.cn/vec_c/wmts?service=wmts&request=GetCapabilities&tk=your_token" - 检查本地防火墙设置
6. WebGL扩展方案
虽然本文聚焦桌面端，但很多用户也需要WebGL方案。核心要点是：
- 使用Cesium作为渲染引擎
- 通过代理服务解决跨域问题
- 瓦片URL模板示例：
`https://t{s}.tianditu.gov.cn/vec_c/wmts?SERVICE=WMTS&REQUEST=GetTile&VERSION=1.0.0&LAYER=vec&STYLE=default&TILEMATRIXSET=w&FORMAT=tiles&TILEMATRIX={z}&TILEROW={y}&TILECOL={x}&tk=${yourToken}` - 动态切换子域t0-t7实现负载均衡
在实际项目中，建议将天地图与超图自有服务叠加使用。比如用天地图做底图，用SuperMap iServer发布业务数据，既能保证底图稳定性，又能灵活控制业务图层。最近完成的某省自然资源项目就采用这种架构，日均访问量超过2万次未出现服务中断。
