ArcGIS Portal集成天地图底图配置指南

1. ArcGIS Portal添加天地图底图的背景与必要性

作为一名长期从事地理信息系统工作的技术人员，我深知底图服务在实际项目中的重要性。ArcGIS Portal作为企业级GIS平台的核心组件，其默认提供的Esri底图库虽然内容丰富，但在国内网络环境下经常面临访问不稳定甚至完全无法加载的情况。这直接影响了日常工作的效率，尤其是在需要快速展示地理数据的场景下。

天地图作为国内权威的地理信息服务，不仅数据更新及时，而且访问速度稳定，完全符合我国的地理信息标准。将天地图集成到ArcGIS Portal中，可以完美解决Esri底图访问不畅的问题。更重要的是，天地图提供了多种服务类型（影像、矢量、地形）及其对应的注记图层，能够满足不同业务场景的需求。

在实际操作中，我发现很多同行虽然知道这个解决方案，但在具体实施时还是会遇到各种问题。下面我将结合自己多次实施的经验，详细介绍整个配置过程，并分享一些容易忽略的关键细节。

2. 前期准备工作

2.1 获取天地图服务密钥

在开始配置前，首先需要申请天地图的服务密钥（API Key）。这个步骤看似简单，但有几个关键点需要注意：

1. 访问天地图官方网站的服务申请页面，注册开发者账号（如果还没有的话）。
2. 创建新应用时，必须将应用类型设置为"浏览器端"。这一点非常重要，因为Portal是通过浏览器直接调用天地图服务的。
3. 记录好申请到的密钥，后续配置中会多次使用。

提示：一个常见的错误是将应用类型误选为"服务器端"，这会导致Portal无法正常加载天地图服务。

2.2 了解天地图服务URL结构

天地图提供了多种类型的服务，每种服务都有特定的URL格式。以下是主要的服务类型及其URL模板：

在实际使用中，需要将URL中的"您的密钥"替换为前面申请到的真实密钥。同时注意，{z}、{y}、{x}是WMTS服务的标准参数，分别表示缩放级别、行号和列号，不需要修改。

3. 在Portal中添加天地图服务

3.1 添加基础地图图层

1. 登录ArcGIS Portal，点击"地图"进入地图查看器。
2. 在顶部工具栏选择"添加" > "从Web添加图层"。
3. 在弹出的对话框中：
   • 选择"切片图层"类型
   • 输入对应天地图服务的URL（如影像地图URL）
   • 勾选"用作底图"选项
   • 为图层指定一个有意义的名称（如"天地图影像"）
4. 点击"添加图层"完成操作。

这个过程看似简单，但有几个技术细节值得注意：

• 切片图层（Tile Layer）与动态图层（Feature Layer）的区别：天地图提供的是预先渲染好的图片切片，因此必须选择切片图层类型。
• "用作底图"选项决定了图层的显示顺序和行为特性。底图图层会被固定在最下层，且不支持某些交互操作。

3.2 添加注记图层

注记图层（如道路名称、POI点等）需要单独添加，方法与添加基础地图类似，但有两点关键区别：

1. 不要勾选"用作底图"选项，这样注记才能显示在地图内容之上。
2. 注记图层的URL与基础地图不同，需要使用专门的注记服务URL。

添加完成后，建议调整两个图层的透明度进行测试，确保注记能够正确叠加在基础地图之上。

4. 创建和管理底图库

4.1 保存自定义地图

添加完天地图服务后，建议将当前地图保存为一个新的地图项目：

1. 点击"保存" > "另存为"。
2. 输入有意义的名称，如"天地图影像(墨卡托)"。
3. 添加适当的标签和描述，便于后续管理。
4. 选择适当的共享范围（通常先保存为私有）。

4.2 创建底图库群组

为了将自定义的天地图底图纳入Portal的底图库系统，需要创建一个专门的群组：

1. 导航到"群组"页面，点击"创建群组"。
2. 设置群组名称为"Basemap"或其他有意义的名称。
3. 配置适当的共享设置（通常为组织内共享）。
4. 将之前保存的天地图地图共享到这个群组。

4.3 配置系统底图库

最后一步是将自定义群组设置为系统的默认底图库：

1. 以管理员身份进入"组织" > "设置" > "地图"。
2. 在"底图库群组"部分，选择刚才创建的"Basemap"群组。
3. 保存设置。

完成这些步骤后，所有用户在创建新地图时，都可以在底图库中选择我们添加的天地图服务了。

5. 高级配置与问题排查

5.1 保留Esri默认底图

如果组织内仍有使用Esri底图的需求，可以在"组织" > "设置" > "地图"中点击"共享底图"按钮。这会将Esri的默认底图也添加到当前底图库群组中，用户就可以在天地图和Esri底图之间自由切换了。

5.2 常见问题与解决方案

在实际部署过程中，可能会遇到以下典型问题：

1. 地图无法加载

   • 检查API Key是否正确，特别是确认应用类型为"浏览器端"
   • 验证URL格式是否正确，特别是{z}/{y}/{x}参数是否保留
   • 检查网络连接，确保可以访问天地图服务域名

2. 注记与底图错位

   • 确认使用的是同一坐标系的服务（通常都是Web墨卡托）
   • 检查是否同时添加了基础地图和对应的注记图层

3. 性能问题

   • 天地图服务在国内访问通常很快，如遇卡顿可检查本地网络
   • 考虑在网络边界部署缓存服务，减少对外部服务的依赖

5.3 多类型底图配置

为了提供更丰富的选择，建议配置多种类型的天地图服务：

1. 影像地图：适合展示实际地表情形
2. 矢量地图：适合常规业务地图展示
3. 地形地图：适合需要展示高程信息的场景

每种类型都应包含基础地图和注记图层，并按照上述方法添加到底图库中。这样最终用户就可以根据实际需要选择最合适的底图类型。

6. 实际应用建议

经过多次项目实践，我总结出以下几点经验：

1. 密钥管理：将天地图API Key存储在安全的地方，定期检查使用量。如果Key泄露或需要更换，所有使用该Key的地图都需要更新URL。

2. 服务监控：建立简单的监控机制，定期检查天地图服务的可用性。虽然天地图服务很稳定，但偶尔也会有维护窗口。

3. 备用方案：考虑在本地缓存常用区域的底图，作为天地图服务不可用时的后备方案。ArcGIS Portal支持本地切片包的发布和使用。

4. 用户培训：为终端用户提供简单的使用指南，说明如何在不同底图类型间切换，以及每种底图适合的使用场景。

这套解决方案在我参与过的多个大型项目中都得到了成功应用，显著改善了地图服务的访问体验。特别是在一些对实时性要求较高的应急指挥系统中，稳定的底图服务为决策提供了可靠支持。