避开401和403：天地图API密钥在QGIS中配置的完整避坑指南

天地图API密钥在QGIS中的终极排错手册：从401到403的全面攻克

当你第一次尝试在QGIS中加载天地图服务时，那种期待与兴奋是难以言表的。但现实往往很骨感——地图窗口一片空白，或者弹出令人沮丧的401、403错误代码。作为一名GIS工程师，我完全理解这种挫败感。本文将带你深入排查这些问题，从密钥申请到最终显示，一步步拆解可能出错的环节。

1. 密钥申请阶段的隐藏陷阱

很多人以为申请密钥就是填个表单那么简单，但实际上这里有几个关键点直接影响后续使用：

• IP白名单设置：天地图要求明确指定访问IP，但这里有个常见误区——很多人只添加了公司或家庭的固定IP，却忽略了移动办公时动态IP的变化。建议将整个IP段加入白名单，比如123.123.123.*。

• 密钥有效期：天地图API密钥默认有使用期限，过期后自然会出现401错误。在申请时就要记录下过期时间，设置日历提醒。

• 服务类型选择：不同的地图服务（矢量、影像、地形）可能需要单独授权。确保你申请的密钥权限覆盖了所有需要的服务类型。

提示：申请密钥后不要立即关闭页面，保存好密钥ID和重置链接。我就曾因为浏览器崩溃而不得不重新申请。

2. URL构造的艺术与科学

即使有了有效密钥，URL构造不当也会导致地图加载失败。以下是几个关键检查点：

2.1 投影类型的选择

天地图支持两种主要投影方式，对应不同的URL路径：