没有哪个GIS人没被在线底图折腾过。ArcGIS Pro 3.0里要加载天地图WMTS服务说简单也简单说坑也真坑尤其是那个偏移问题轻则图层对不上重则整个项目返工。如果你也在ArcGIS Pro里被天地图WMTS搞得头疼或者正卡在Key申请这一步不知道怎么填这篇文章就是给你准备的保姆级参考。我会从WMTS的原理讲起把为什么会出现偏移、怎么从根上避免偏移说明白再手把手带你走一遍天地图Key申请流程和ArcGIS Pro 3.0加载步骤。适合刚接触ArcGIS Pro的新人也适合被坐标系和偏移折磨过的老手。内容都是我实际踩过坑以后整理出来的按顺序操作基本能一次搞定。1. 为什么选WMTS加载天地图而不是WMS或XYZ1.1 WMTS到底是个什么东西WMTS全称是Web Map Tile Service中文叫网络地图瓦片服务。它和常见的WMS比最大的区别就是WMTS把地图预先切成了很多张固定大小的瓦片每张瓦片都有固定的行列号客户端要哪块就请求哪块而WMS是每次动态渲染整幅图再返回给你。我打个比方。WMS就像你每次去餐厅都让厨师现炒一桌菜等的时间长但菜是热的WMTS就像餐厅提前蒸好了几千笼包子你拿哪笼直接端走速度快但只能拿现成的不能临时改口味。对GIS软件来说WMTS的加载速度明显更快而且服务器压力小。ArcGIS Pro 3.0里加载天地图WMTS是官方稳定支持的方式。尤其是做数据查看、底图叠加、外业核对这类场景WMTS比WMS顺手得多。你不用去关心它内部怎么切片只要知道它提供的是“已经切好的规范瓦片”就够了。1.2 天地图WMTS服务提供的版本和坐标系天地图官方目前提供的地图类型包括矢量底图vec、影像底图img、地形底图ter、全球注记cia、矢量注记cva等。每种地图按照坐标系不同还细分出不同的发布端点。其中最重要的就是这两个后缀_w结尾Web墨卡托投影坐标系对应EPSG:3857也就是Google Maps、Esri在线底图用的那套。_c结尾CGCS2000地理坐标系对应EPSG:4490也就是国家大地坐标系的经纬度版本。具体拼接URL的时候是这样的格式https://t0.tianditu.gov.cn/vec_w/wmts?tk你的Key https://t0.tianditu.gov.cn/vec_c/wmts?tk你的Key https://t0.tianditu.gov.cn/img_w/wmts?tk你的Key https://t0.tianditu.gov.cn/img_c/wmts?tk你的Keyt0可以换成t1、t2、t3、t4、t5、t6、t7这些是天地图的瓦片服务器节点换着用可以分担请求压力。1.3 偏移问题的根源其实在坐标系上绝大多数人说“天地图加载后有偏移”并不是天地图服务坏了而是你的ArcGIS Pro工程坐标系和WMTS切片的坐标系没有对齐。举个例子。你的项目用高斯投影或者Web墨卡托你加载的天地图是vec_cCGCS2000经纬度Pro会尝试动态重投影瓦片把经纬度瓦片显示到你的投影坐标系下。这个过程本身没问题但动态重投影对操作顺序、缓存、软件版本都有要求。一旦某个环节没设置对瓦片网格和你的数据就错位了看起来就是“偏移”。所以解决偏移问题的思路不是去手动挪图层而是要先把坐标系这件事情理顺。后面我会专门讲怎么处理。2. 保姆级天地图Key申请流程2.1 注册账号与实名认证天地图Key现在不能直接匿名申请必须先注册并完成实名认证。打开天地图官网www.tianditu.gov.cn右上角找“注册”用手机号或者邮箱创建账号。注册完以后登录进控制台系统会引导你进行实名认证。个人用户一般需要提供身份证信息配合人脸识别企业用户则需要营业执照、法人信息等。这个环节的目的就是确保地图服务的使用者信息可追溯属于正常流程不用多想。我从实际经验提醒一句实名认证别拖没有实名认证你连应用都创建不了。我第一次就是注册完直接跑去创建应用结果被卡在“请先完成实名认证”又回头折腾了十分钟。2.2 创建应用最关键的一步登录控制台后找到“开发中心”或“控制台”里的“创建应用”按钮。这里你需要选择应用类型常见的有应用类型用途主要限制适合场景浏览器端Web网页中用JavaScript调用必须配置域名白名单只有白名单里的域名能正常访问网页GIS开发、前端项目服务端桌面软件、服务端程序、脚本调用需要配置IP白名单从白名单中的IP请求才有效ArcGIS Pro、QGIS、Python脚本这里特别重要。如果你用的是ArcGIS Pro、QGIS这种桌面GIS软件一定要选“服务端”类型这样生成的Key才是适合桌面端调用的服务端Key。如果选了浏览器端你拿着它往ArcGIS Pro里填大概率会遇到无响应或者无法连接浪费半天时间去搜“为什么我的Key不能用”。创建应用后系统会给你两个Key一个是浏览器端Key一个是服务端Key。桌面GIS用户直接复制服务端Key。注意不要搞混两个Key格式差不多但使用范围完全不同。2.3 配置白名单和常见Key错误服务端Key创建时一般会让你填IP白名单。这个白名单是“允许使用该Key的IP地址列表”。如果你用的是固定IP的办公网络直接填那个IP如果是家用宽带每次拨号IP都有可能会变你可以暂时填当前出口IP。这里有个容易踩的坑白名单没配置好或者IP变了没更新会导致请求返回403或提示“非法Key”。很多人第一反应是Key过期了其实绝大多数是白名单拦截。关于“非法Key”这类报错我帮大家梳理一下常见原因Key拼写错误多复制了一个空格或者漏掉了后面的字母。应用类型选错桌面端用了浏览器端Key。白名单没生效服务端Key没填IP白名单或者当前IP不在白名单里。密钥状态异常实名认证未通过或应用被官方停用。我建议你把申请下来的Key存放在一个文本文件里同时备注好应用类型、白名单IP、申请日期。这个小习惯能帮你后续排查问题时省下很多时间。3. ArcGIS Pro 3.0里加载天地图WMTS的完整操作3.1 准备工作先把几个前提条件确认好在动手之前你至少需要确认三件事ArcGIS Pro已经安装并能正常启动建议是3.0或更高版本。版本越新对WMTS的支持越稳定。电脑能正常访问天地图服务。可以先用浏览器打开下面这个地址试试能打开就说明网络通https://t0.tianditu.gov.cn/vec_w/wmts?tk你的Key LAYERvecSTYLEdefaultTILEMATRIXSETwFORMATtilepngTILEMATRIX0TILEROW0TILECOL0浏览器如果返回一张小图片或者显示一堆二进制乱码说明Key和网络都是通的。手上有天地图服务端Key并且IP白名单里包含你当前使用的IP。3.2 在ArcGIS Pro中新增WMTS服务器连接打开ArcGIS Pro新建一个空白地图工程。在Catalog目录窗格里找到“Servers”节点也就是“服务器”那一个分类。右键点击“Servers”选择“Add WMTS Server”会弹出一个对话框让你填写WMTS服务URL。把你准备好的天地图地址填进去例如https://t0.tianditu.gov.cn/vec_w/wmts?tk你的服务端Key点击“OK”后Catalog里会出现一个服务器连接节点。展开这个节点你就能看到天地图WMTS发布出来的几个图层常见的图层名有“vec”“img”“ter”等。这个操作本质上是在让ArcGIS Pro去读取WMTS的能力文档也就是GetCapabilities。如果URL填错、Key失效、或者网络不通这一步就会直接失败。3.3 选择图层并添加到地图注意坐标系展开WMTS服务器节点后你会看到若干子图层。比如加载矢量底图就选“vec”加载影像底图就选“img”。右键对应的图层选择“Add To Current Map”也就是“添加到当前地图”。这时候ArcGIS Pro会提示你选择导入坐标系。这一步非常关键直接决定你后面会不会遇到偏移。看下面这个选择逻辑如果你刚才用的URL是vec_w建议把坐标系选为WGS 1984 Web Mercator (Auxiliary Sphere)也就是EPSG:3857。如果你用的URL是vec_c建议把坐标系选为CGCS2000也就是EPSG:4490。如果你的工程里自带其他坐标系的数据尽量先确定工程的主坐标系再选择对应的WMTS端点和导入坐标系。很多人到这里都容易犯一个错不管三七二十一直接点默认加进去发现地图偏移了又来问我怎么办。其实提前想清楚工程坐标系这个问题是可以避免的。3.4 添加多个图层时的顺序和样式问题如果你想叠加矢量底图加注记也就是vec配合cva使用添加顺序一般先底图后注记。注记图层的透明度也可以调整方便让底图显示更清楚。在ArcGIS Pro的Contents内容窗格里你可以看到已添加的WMTS图层。每个图层的属性里有一个“Layer”属性代表当前显示的地图类型。这个不需要你手动改ArcGIS Pro会根据服务器返回的图层信息自动匹配。WMTS图层添加到地图后不要在Contents里随便右键“Zoom To Layer”去缩放因为没有数据范围的概念最好是直接缩放到底图的全图范围。4. 偏移问题到底怎么解手把手帮你定位4.1 偏移的常见表现和定位方法天地图加载进来后发现“对不上”通常表现出几种情况瓦片和矢量数据之间有明显错位几百米甚至上千米。底图瓦片有黑边、破碎显示区域对不齐。瓦片加载正常但越往地图边缘越偏移。定位问题的第一步新建一个空白地图工程只添加天地图WMTS不加任何本地数据。如果天地图自己显示连续、无错位说明服务没问题。问题出在你工程的数据坐标系和WMTS坐标系之间。第二步把你的数据添加进来打开地图属性Map Properties查看当前坐标系是什么。然后再看WMTS图层属性里的坐标系是什么。两个坐标系如果不一致ArcGIS Pro会做动态投影偏移就在所难免。4.2 方案一挑选正确的WMTS端点这是最推荐的方案。天地图提供了_w和_c两种瓦片网格你需要根据工程坐标系来选。如果你的工程坐标系是Web墨卡托EPSG:3857那就用vec_w、img_w这些带_w的端点。如果你的工程坐标系是CGCS2000经纬度EPSG:4490那就用vec_c、img_c。很多教程只让你填vec_w完全不管用户工程是什么坐标系这才会导致一大半人加载后出现偏移。学会根据自己的工程坐标系选端点才是根治偏移的最优解。4.3 方案二在ArcGIS Pro中设置动态投影有些情况你确实改不了工程主坐标系比如领导指定了某个高斯投影分组或者你的项目数据统一用的是CGCS2000 3度带高斯投影。这时候你需要做的是把WMTS图层添加到地图后在地图属性里确认“允许动态重投影”是开启状态并且把数据框的坐标系设置为你工程的主坐标系。ArcGIS Pro默认是允许动态重投影的所以理论上即使你加载了vec_w再到高斯投影的工程里也只会产生轻微的显示误差。但WMTS的切片网格和投影网格越接近显示越准确所以能用_w匹配Web墨卡托、用_c匹配CGCS2000经纬度就不要交叉使用。4.4 方案三数据和工程坐标系统一从根上消除偏移偏移的根源其实是工程坐标系不统一。这里我给出了一个实践中的检查顺序检查地图底图的坐标系是什么检查每个图层的坐标系是什么尤其是本地矢量数据检查WMTS端点选择的坐标系是什么让三者尽量保持一致或者至少确保数据坐标系和工程坐标系之间的转换关系是正确的。这里有个常见误区WGS84和CGCS2000之间的椭球差异是很小的一般不会造成你看到的几百米偏移。真正的偏差往往来自投影方式不同比如你用Web墨卡托的去对应CGCS2000投影坐标系。还有可能是你的矢量数据本身坐标系标注错误这个只能靠你自查数据源。5. 常见问题速查与排查心得体会5.1 Key相关的报错速查表报错现象可能原因解决办法401 UnauthorizedKey无效或未通过实名认证检查Key拼写确认应用状态403 ForbiddenIP白名单未配置或不在白名单中到天地图控制台更新IP白名单301001 非法KeyKey类型使用错误或Key被停用确认是否是服务端Key查看应用状态无法连接服务器URL格式错误或网络不通用浏览器先测试同样的URLWMTS图层添加后空白坐标系选择错误或切片格式不支持换一个端点后缀检查FORMAT参数5.2 图层能加载但一直转圈这种情况一般是网络波动或者请求频率太高。天地图对单个Key的并发请求是有限制的如果你同时开很多个地图窗口或者短时间内频繁刷新很容易触发限流。我自己的做法是在同一时间内尽量减少不必要的刷新操作如果只是当作底图看不缩放不漫游把它当背景图层来看待。另外可以换不同的服务器节点比如把t0换成t1、t2分散请求压力。5.3 天地图图层和本地数据始终对不上如果你已经确认WMTS端点选对了坐标系也都统一了还是对不上那问题很可能出在本地数据上。可以用ArcGIS Pro的“Define Projection”定义投影工具检查数据源是否有投影信息。比如某些从互联网上下载的GeoJSON或Shapefile坐标系可能是WGS84但属性信息里却写着CGCS2000或者干脆没有定义坐标系。这种数据加载到任何地图软件里都可能出现位置偏差。解决办法是用“Project”工具重新投影或在数据源层面修正坐标系定义。5.4 我的几个实操经验帮你少走弯路天地图WMTS加载这事我前前后后处理过不下几十次几点经验分享给你们第一Key一定要区分浏览器端和服务端。ArcGIS Pro里就用服务端Key别在网页示例代码里直接抄一个浏览器端Key来填。第二工程没建之前先想坐标系。临时加载天地图看看直接用Web墨卡托正儿八经做项目先建工程定好坐标系再选WMTS端点。第三别频繁切换_w和_c。你反复切换会生成一堆临时缓存ArcGIS Pro的WMTS缓存偶尔会发疯导致地图刷新异常。遇到这种情况清一下工程缓存或重启Pro就行。第四如果只是浏览查看建议把WMTS图层设置为不可选避免误操作。在Contents里取消勾选图层的可选择性这样后续做其他操作时不会选中一堆瓦片网格。还有个小技巧如果你需要把WMTS服务的地址共享给同事建议把完整URL写清楚并且附上应用类型和Key。协作的时候别人一看就知道怎么填不用再来回问。用ArcGIS Pro加载天地图其实就是把服务地址、Key、坐标系这三件事理清楚。服务地址选对端点Key走服务端申请坐标系和工程保持一致偏移自然不会再出现。我个人的习惯是先确认工程坐标系再决定用_w还是_c这个顺序千万别搞反。最后再提醒一次加完天地图后如果发现偏移先别急着手动平移图层老老实实检查坐标系和WMTS端点这才是正道。