企业官网建设流程全解析

1. 天地图WMTS的坐标系门道：偏移问题到底从哪来

先聊一个几乎所有ArcGIS Pro用户第一次接天地图都会撞上的问题：图层加进来了，影像也出来了，但叠加自己的矢量数据时，道路跑到了河对岸，建筑轮廓和张地图对不上，偏移量一看几百米甚至更远。这不是操作错误，也不是天地图服务不稳定，而是坐标系不匹配造成的必然结果。

天地图作为国家地理信息公共服务平台，提供的WMTS服务遵循的是CGCS2000（2000国家大地坐标系），而国内很多同行在ArcGIS Pro里做项目时，拿到的数据源底图、GPS采集数据或者从公开渠道下载的矢量数据，往往还在使用WGS-84坐标，甚至有些数据源混入了GCJ-02（火星坐标系）的偏移逻辑。三个坐标系之间的参考椭球体参数、投影方式、加密偏移算法都不一样，直接叠在一起不出问题才怪。

这里需要解释清楚一个容易混淆的概念：天地图的WMTS服务本身并不存在“偏移”。它不是把地图画歪了，而是它告诉客户端的“这个点在哪”和你数据的“这个点在哪”用的不是同一套空间参考。ArcGIS Pro在加载WMTS服务时，默认会按照服务文档里声明的坐标系去渲染。如果服务声明的是CGCS2000，你的数据框坐标系也是CGCS2000，那理论上完全对齐。但问题恰恰出在——ArcGIS Pro的数据框默认坐标系是WGS_1984_Web_Mercator_Auxiliary_Sphere，很多新手压根没注意到这个默认值，拿WGS84的矢量数据叠加CGCS2000的WMTS影像，偏移几百米只是起步价。

另外还有一个更隐蔽的情况：如果数据本身是被加密偏移过的GCJ-02坐标系，比如一些开源地图上扒下来的POI数据，叠加天地图时会产生更离谱的偏移，甚至几百米到几公里都有可能。这种情况不是调整数据框坐标系能解决的，必须对数据做逆向纠偏。

所以在开始加载天地图之前，有两件事必须先确认清楚：

• 你的目标数据框坐标系到底是哪一个？
• 你的数据源坐标系到底是不是它声明的那样，是否夹杂了GCJ-02加密偏移？

搞清楚这两点，后面所有步骤才有意义。如果数据本身就是干净的CGCS2000或WGS84坐标，只需要在加载WMTS时统一数据框坐标系即可解决偏移。

2. 申请天地图Key：新版流程与那些让人抓狂的报错

2.1 从匿名访问到Key认证：天地图服务的访问规则变化

早年间天地图的WMTS服务是可以匿名访问的，直接把瓦片地址丢进软件里就能用。后来出于安全合规和服务质量考虑，天地图全面启用了Key认证机制。现在无论是浏览器端的JavaScript API、服务端的WebService接口还是WMTS瓦片服务，都必须携带有效的Key才能正常访问。

这个变化让很多人栽了跟头。网上搜到的大量老教程还停留在“不需要Key”或者“随便填一个Key”的阶段，照着配完，要么地图一片空白，要么弹出Invalid Key或者非法Key的报错。更要命的是，天地图的报错信息并不统一，有返回code: 301001 / 非法key的，有提示key值未知的，还有在ArcGIS Pro里直接加载失败、连具体错误原因都不给的。

2.2 Key申请完整流程：从注册到获取浏览器端Key

天地图Key的申请入口在天地图官方网站的开发者中心。完整流程如下：

第一步：注册并实名认证

访问天地图官网，点击右上角注册。建议直接用手机号注册，后续操作比较省事。注册完成后，进入个人中心需要完成实名认证——个人用户上传身份证正反面照片，企业用户则需要上传营业执照。认证审核一般几分钟到几小时内完成，审核通过后才能创建应用并申请Key。

有朋友问我能不能跳过实名认证，答案是没办法跳过。从2019年之后天地图全面收紧政策，所有Key申请必须走完实名认证，这也是为了追溯调用方责任。但好消息是个人实名认证门槛并不高，不需要公司资质。

第二步：创建应用

登录后进入控制台，找到“应用管理”或“我的应用”，点击“创建应用”。创建时需要填写：

• 应用名称（例如“GIS数据比对项目”）
• 应用类型（一般选择“浏览器端”即可，如果需要在ArcGIS Pro或桌面软件里调用，同样选浏览器端）
• 行业类别、应用描述等辅助信息

需要注意，应用类型务必选择“浏览器端”，因为ArcGIS Pro通过WMTS加载天地图时，请求方式与浏览器端的JavaScript API调用类似，使用的是浏览器端Key。选错类型可能导致后续请求被拒。

第三步：获取浏览器端Key

创建完成后，应用详情页会显示两个Key：一个是浏览器端Key，一个是服务端Key。加载天地图WMTS服务用到的是浏览器端Key，复制保存下来。

注意： 天地图的Key绑定域名/IP。创建应用时如果填了域名白名单，那么只有白名单内的域名发起的请求才会被放行。如果要在ArcGIS Pro里加载，建议域名白名单留空，或者填写“*”（允许所有来源），否则可能因为请求来源不在白名单内而加载失败。这个限制是天地图专门针对浏览器端Key设置的防盗刷机制，但对桌面端调用就变成了负担。

第四步：在ArcGIS Pro中配置Key

Key本身并不直接在ArcGIS Pro里输入，而是拼接在WMTS服务地址的URL参数里。具体拼接方式后文会详细讲。这里先记住一个要点：Key是URL的一部分，不是软件设置项。

2.3 Key申请和使用中你一定会遇到的报错清单

我踩过的坑比较典型，列出来大家对照排查：

还有一个冷门但很现实的坑：天地图官网偶尔会改版，Key管理页面的入口位置会变化，很多人迷路。如果找不到“应用管理”，直接在官网首页搜索“控制台”或“开发者中心”，多半能找到入口。

3. ArcGIS Pro 3.0 加载天地图WMTS：保姆级操作步骤

3.1 确认天地图WMTS服务的标准地址结构

天地图的WMTS服务地址有标准格式，官网文档和网上教程里经常出现两种写法，一种是不带Key的老版本URL，一种是带Key的新版URL。很多新手拿老版本URL去加载，结果永远失败。这里直接给出目前可用的标准格式。

天地图WMTS服务的基础地址是：

https://t0.tianditu.gov.cn/img_w/wmts?SERVICE=WMTS&REQUEST=GetTile&VERSION=1.0.0&LAYER=img&STYLE=default&TILEMATRIXSET=w&FORMAT=tiles& TILEMATRIX={z}&TILEROW={x}&TILECOL={y}&tk=你的Key

但ArcGIS Pro加载WMTS服务时，并不需要直接拼这种细节到瓦片级别的地址，它需要的是服务根地址（GetCapabilities地址）。ArcGIS Pro会自动从根地址解析出图层、坐标系、瓦片矩阵集等信息。所以我们要在ArcGIS Pro里填写的URL是：

https://t0.tianditu.gov.cn/img_w/wmts?SERVICE=WMTS&REQUEST=GetCapabilities&tk=你的Key

这里注意关键点：

• t0到t7：天地图有多个瓦片子域名（t0、t1、t2……t7），任意一个都可以用。如果某个子域名响应慢，换一个即可。
• img_w：影像底图（墨卡托投影）。还有矢量底图vec_w、地形地图ter_w、影像注记cia_w、矢量注记cva_w、地形注记cta_w等，按需替换。
• _w后缀代表Web墨卡托投影；还有一个_c后缀代表CGCS2000地理坐标系。对多数项目来说，用_w就够了。
• tk=你的Key是请求的令牌参数，必须携带。

3.2 在ArcGIS Pro中添加WMTS服务：从目录到地图的完整路径

打开ArcGIS Pro 3.0，新建一个空白地图工程，然后按下述步骤操作：

1. 在左侧“目录”窗格中，展开“地图”节点，右键选择“添加WMTS服务”，也可以用更直接的方式：在顶部“地图”选项卡中，找到“添加数据”下拉按钮，选择“来自路径的数据”。
2. 在“添加数据来自路径”对话框中，选择“服务器或文件夹”为“WMTS服务器”，在URL输入框中粘贴上面构造好的GetCapabilities地址。如果粘贴正确，系统会自动检测并解析出服务能力信息。
3. 点击“添加”，等待数秒，ArcGIS Pro会弹出“图层配置”向导，展示服务中可用的图层列表。天地图WMTS的图层名称一般是img、vec、ter等。勾选需要的图层（比如影像底图img），点击“添加”。
4. 返回地图视图，影像瓦片会自动加载。此时如果一切顺利，你就能看到完整的天地图影像。

需要注意的是，ArcGIS Pro解析WMTS服务时，会把一个服务根地址下所有图层都解析出来。你不需要全部添加，只添加自己需要的那几个即可。添加多个图层时，也可以按住Ctrl复选。

3.3 数据框坐标系设置：做不对这一步，偏移永远存在

添加天地图WMTS之后，最重要的一步来了：把地图的数据框坐标系设置成和WMTS图层一致的坐标系。

在ArcGIS Pro中，数据框就是Contents（内容）窗格里最顶层的Map。右键单击“Map”，选择“属性”，切到“坐标系”选项卡。这里要确保所选坐标系与天地图WMTS服务一致。

如果你使用上述_w后缀的地址，那天地图的瓦片坐标系是WGS_1984_Web_Mercator_Auxiliary_Sphere（EPSG:3857），请将数据框坐标系也设置为该坐标系。设置路径：坐标系 → 投影坐标系 → World → WGS 1984 Web Mercator (auxiliary sphere)。也可以直接在搜索框输入“3857”快速定位。

这里为什么会偏移的问题就彻底清晰了：如果数据框坐标系默认是WGS84地理坐标系（EPSG:4326），而瓦片服务是Web墨卡托（EPSG:3857），ArcGIS Pro虽然会在显示时做动态投影，但因为两种坐标系的投影方式不同，动态投影的结果通常不会精确匹配，叠加后肉眼可见的偏移就成了必然。把数据框坐标系手动切换到投影坐标系，让所有图层在同一坐标框架下实时渲染，偏移基本消除。

3.4 图层顺序与显示效果优化

添加完成后还有个常见问题：天地图影像底图把自己的矢量数据盖住了。解决方法是把矢量和注记图层放到影像底图之上。在“内容”窗格里直接拖拽排序即可。

如果同时添加了影像底图和影像注记（如地名标注），需要把注记放在底图上方，这样地名才能显示在影像之上。实际操作中，我习惯的顺序是：

1. 矢量数据层（最上层）
2. 天地图矢量注记/影像注记
3. 天地图影像底图/矢量底图（最底层）

另外一个容易忽略的点是透明度和亮度调整。影像底图如果太亮，配合矢量半透明图层时容易看不清。可以选中影像图层，在“符号系统”或“效果”里适当调整透明度，方便叠加分析。实测下来，透明度降到70%左右时，影像与矢量数据叠加效果比较理想，既能看清影像纹理，又不会盖住矢量符号。

4. 坐标系不匹配时的偏移校正方案与实操验证

4.1 方案一：直接统一到Web墨卡托（最推荐）

这是最省事也最不容易出错的方案。在加载天地图WMTS之前，或者加载完成之后，把数据框坐标系设为WGS_1984_Web_Mercator_Auxiliary_Sphere（EPSG:3857），然后把所有矢量数据通过“投影”（Project）工具转换到该坐标系。

具体操作：打开“分析”选项卡 → “工具”，搜索Project工具，输入要素选择你的矢量数据，输出坐标系选择WGS_1984_Web_Mercator_Auxiliary_Sphere，运行。转换完成后，把原始数据从地图中移除，加载转换后的结果，再和天地图叠加验证偏移。

这个方案适合绝大多数WGS84来源数据的场景，因为Web墨卡托本身就是WGS84椭球体上的墨卡托投影，坐标转换是严格数学变换，没有损失和偏差。叠加效果精确到像素级，肉眼完全看不出来偏移。

4.2 方案二：将数据框设为CGCS2000，数据也转成CGCS2000

如果项目后期的成果要求必须使用CGCS2000坐标系（很多自然资源、测绘类项目都这么要求），那就不能图省事用Web墨卡托了。此时要加载天地图CGCS2000版本的WMTS服务（使用_c后缀地址），同时把矢量数据从WGS84转换到CGCS2000。

天地图提供的_c后缀服务，坐标系是CGCS2000 地理坐标系（EPSG:4490），瓦片矩阵集会根据经度纬度计算。加载方式与_w版本完全一致，只需替换URL中的图层名：

https://t0.tianditu.gov.cn/img_c/wmts?SERVICE=WMTS&REQUEST=GetCapabilities&tk=你的Key

数据转换操作也一样，用Project工具，目标坐标系选择CGCS2000（EPSG:4490）。需要特别提醒的是，WGS84和CGCS2000两个坐标系之间的差值在大部分区域只有厘米级到亚米级，对于普通制图和可视化几乎不影响，但如果做高精度测量或形变监测，不建议用四参数/七参数以外的通用转换，最好结合当地控制点做转换参数校正。

4.3 方案三：处理GCJ-02火星坐标系偏移（只能对症下药）

这是最棘手的情况。如果手里的数据是GCJ-02坐标系（最典型的表现是：叠加天地图后偏移约300~500米），那就不是设置坐标系能解决的。

GCJ-02是中国大陆地区对WGS84坐标做非线性加密偏移后得到的坐标系，没有公开的官方转换公式。它的偏移量不是固定常数，而是随位置变化的随机值。市面上有一些公开的逆向纠偏算法，大多是通过反算偏移网格实现，精度能恢复大部分区域到几米以内，但对特殊区域（如军事管制区）有时会失效。

具体操作思路是：用算法库（比如开源GIS库或在线转换工具）把你的GCJ-02数据先转回WGS84，再按方案一或方案二继续处理。但这套方法只适用于精度要求不高的可视化场景，如果项目对精度有硬性要求，强烈建议重新采集或从正规渠道获取原始WGS84坐标系数据，GCJ-02数据经逆向纠偏后做定量分析风险很大，出了问题没人替你背书。

4.4 偏移验证：怎么判断到底对齐没有

加载完天地图、处理完数据，怎么确认偏移真的解决了？三个快速验证方法：

1. 道路河流交叉口比对：找一块道路与水系交叉明显的区域，放大到1:5000左右，看矢量道路和水系影像是否严格压合。
2. 建筑物轮廓比对：找一个轮廓清晰的建筑（比如操场、场馆、大型商超），叠加矢量面数据看边线是否重合。
3. 控制点精度检查：如果手头有RTK实测的WGS84控制点，在ArcGIS Pro里标注出来，和天地图影像对照，偏移量应小于遥感影像本身的几何精度。

实测过的情况是：数据框设置正确后，道路中心线和影像道路的偏差肉眼几乎不可见，放大到1:2000时偶尔有半米到一米的偏差，这大概率是影像配准误差，不是坐标系问题。如果放大后偏移依然在几十米级别，那几乎可以断定数据坐标系判断错误或者转换没生效。

5. 加载失败的常见报错与完整排查链路

5.1 排查起点：分清问题出在网络层、协议层还是Key层

天地图WMTS加载报错，很多人第一反应是“Key有问题”，但我在实际调试中发现，真正由Key本身导致的问题占比不到三分之一，网络连接、代理设置、ArcGIS Pro的缓存机制反而更容易闹鬼。

排查链路建议按这个顺序走：

1. 先用浏览器验证网络连通性：把GetCapabilities地址直接扔到浏览器地址栏，如果浏览器能正常返回一坨XML内容，说明网络通、Key有效、服务正常；如果浏览器报错，就看报错内容判断是Key还是域名白名单问题。
2. 再用ArcGIS Pro连接一次：排除浏览器缓存、Cookie等干扰后，如果浏览器能打开但Pro不行，大概率是Pro的缓存或配置问题，此时清缓存、重启工程。
3. 最后检查Key：前面两步都排除了，才回头审视Key本身。

这个顺序能帮你少走很多弯路。网上太多人一上来就怀疑Key，结果折腾半天发现是单位网络代理把HTTPS请求拦截了。

5.2 报错“public key retrieval is not allowed”是什么鬼

这个报错名称听起来像Key的问题，但它其实和天地图Key完全无关。它一般出现在ArcGIS Pro连接某些PostgreSQL空间数据库或企业级地理数据库时，数据库连接配置里禁用了公钥检索机制，导致SSL握手失败。遇到这个报错不要往天地图方向想，应该检查数据库连接属性里是否勾选了允许公钥检索，或者更换为正确的SSL模式。

很多新手的误区在于：把“天地图Key”和这个报错里的“public key”混为一谈，以为是自己申请Key时哪里没做对。其实前者指的是地图服务API密钥，后者是数据库SSL证书公钥，完全是两码事。我见过有人因为这个报错把天地图的Key重新申请了三次、实名认证都换了个账号，最后发现问题是数据库驱动的版本兼容性。

5.3 加载成功但显示空白瓦片：缓存和投影的隐秘陷阱

还有一种情况：WMTS服务加载成功了，图层列表里也有img图层，但地图窗口一片空白，放大缩小都没有瓦片出现。这个问题通常有两个根源。

根源一：ArcGIS Pro的WMTS缓存冲突。地图文档在之前加载过无效地址或不同参数的WMTS服务，导致瓦片缓存里存了错误索引。解决办法是：删除地图中的天地图图层，关闭工程，删除ArcGIS Pro本地缓存目录（通常在C:\Users\用户名\AppData\Local\ESRI\ArcGISPro\Cache），重启后再重新加载。

根源二：请求URL里{z}/{x}/{y}的替换问题。有些网上流传的地址是把瓦片行列号作为保留字直接放在URL里的（比如TILEMATRIX={z}&TILEROW={x}&TILECOL={y}这种模板），在ArcGIS Pro中，如果服务根地址解析正常，Pro会自动处理这些参数，不需要手工改。但如果你用的是某些第三方插件或者自定义的图层文件，模板里的参数名可能与ArcGIS Pro约定的不同，导致请求失败。检查方法是：把报错时的完整请求URL复制下来，在浏览器里手动访问，换成具体数字，看能否返回图片。

5.4 SSL和代理导致的加载失败：办公室网络的隐形杀手

天地图WMTS地址是HTTPS协议的。如果所在的网络环境有SSL解密网关（常见于企业办公网、高校校园网），ArcGIS Pro发送的HTTPS请求可能被网关拦截或改写，导致证书链验证失败、连接被重置。

这类问题的典型特征是：浏览器能访问天地图（因为浏览器信任网关证书），但ArcGIS Pro连不上（因为Pro默认不信任企业网关的自签名证书）。解决方法有两个：

• 在ArcGIS Pro设置里把企业网关证书导入受信任的根证书颁发机构；
• 或者让网络管理员为ArcGIS Pro的流量做SSL绕过处理。

另外，单位网络如果配置了代理服务器，ArcGIS Pro默认情况下并不自动读取系统代理设置。需要检查“工程” → “选项” → “连接”中是否正确配置了代理服务器。这个坑藏得很深，我在给某测绘院做技术支持时遇到过，他们内外网隔离，内网机器本来能访问天地图，后来安全策略升级后突然全挂，排查到最后发现是代理配置没有同步更新。

6. 日常使用经验：稳定加载天地图的几个实用技巧

6.1 多子域名轮换与请求限速

天地图提供t0到t7共8个子域名，目的就是负载均衡。ArcGIS Pro里加载时一般只填一个子域名，但如果你的工程非常大、加载瓦片数量多，单个子域名可能触发限流。实测下来，影像底图 + 影像注记两个图层分别使用不同的子域名（比如底图用t0，注记用t1），加载速度会明显提升，也更不容易被限流。

另外，天地图对WMTS服务的访问频率有限制，不同注册用户的配额不一样，个人用户一般够用，但如果做批量导出、全屏截图、逐级缩放预览等操作时，瓦片请求会在短时间内暴涨，容易触发临时封禁。解决办法也很简单：控制缩放操作节奏，别一次性从全国缩放到街道级别连滚十几级。

6.2 离线缓存：让常用区域秒开

ArcGIS Pro 3.0本身支持WMTS图层的本地缓存机制。加载天地图后，切换到“地图”选项卡 → “缓存”，可以设置瓦片缓存范围和数据过期时间。对经常使用的区域（比如某个城市、某个区县），提前进行一次全范围缓存，后续打开工程时，这些区域的影像直接从本地读取，不再请求网络，速度提升非常明显。

提示： 缓存范围不要贪大，整市甚至整省的缓存会占用几十GB磁盘空间，而且首次缓存过程漫长。只缓存自己业务涉及的核心区域即可，外围区域用完时按需加载。

6.3 Key的安全管理与防泄漏

天地图的Key虽然不像支付密钥那么敏感，但如果泄露出去被别人刷量，可能触发配额耗尽，影响你的正常使用。在博客、GitHub、技术论坛分享工程文件或代码时，务必把Key处理掉。我自己习惯的做法是：写成环境变量或者配置文件，在分享之前用占位符替换，绝不把Key写死在通篇教程的截图和代码里。

另外如果发现Key已经被盗用（在官方后台能看到调用量异常），及时去控制台重置Key，不用重新申请应用，直接在应用详情页“重新生成”即可，旧Key立即失效。

6.4 把加载好的天地图保存为图层文件，一劳永逸

调好天地图WMTS服务后，建议在内容窗格中选中图层，右键选择“共享为图层文件”或直接保存为.lyrx文件。这样下次新建工程时，直接拖入这个图层文件，填一次Key后永久复用，不需要重新去添加服务、重新设置坐标系、重新调透明度。

把Key写在图层文件的URL里，换电脑、换账号、发同事时也能直接用，但注意随之而来的是Key共享风险。稳妥做法是专为这个用途单独申请一个Key，设置好域名白名单或IP限制，这样就算图层文件外流，Key的权限也被锁死了。

6.5 备选方案：万一天地图服务挂了怎么办

天地图毕竟是公共服务，偶尔也会遇到服务波动。尤其是节假日或重大活动期间，调用量暴涨，个别瓦片有时候会加载不出。我的备选方案通常是同时加载一个可用的在线影像服务作为底图对照，比如ArcGIS Online的World Imagery（如果单位网络能访问），或者本地缓存好的影像。这样天地图临时抖动时，不至于整个工程瘫掉。

多数情况下，天地图WMTS的稳定性其实相当不错，接入Key之后，只要Key白名单配置正确、网络环境干净，连续跑一整天加载都不会出问题。我在实际项目中长期同时加载影像、注记、矢量三套WMTS服务，运行稳定，偏移控制在合理范围内，可以直接用于日常数据检查和业务分析。