先了解需要准备什么
地图用于查看项目地块及在线底图；流程绘制请看可视化画布。添加卫星图源通常需要：服务方账户、获准调用的影像服务、瓦片地址模板，以及自己的 Key 或 Token。
算青山软件本身免费，第三方图源可能有配额、流量或订阅费用。网站能浏览影像，不代表你的账户可以通过 API 调用；购买原始影像文件，也不等于购买了在线瓦片服务。
| 图源 | 官方入口 | 在官方平台准备什么 |
|---|---|---|
| 天地图 | 官网 · 开发资源 · 地图服务说明 | 开发者账户、应用 Key、地图服务权限 |
| 吉林一号 | 吉林一号网 | 在线地图访问或切片影像 API 服务、授权范围、接口地址与凭据 |
| 中科星图 | 星图云开放平台 · 官方接入指南 | 认证账户、影像服务权益、应用 Token |
官方链接在新标签页打开。界面名称、套餐和申请要求可能调整，以登录后的官方页面为准。本文未使用付费账户对三个图源进行实际瓦片调用验收。
使用概念示意，非产品截图；具体操作与能力范围见下文。
在算青山添加图源
打开「设置 → 地图 → 添加图源」。地图右下角也有「添加地图源」或图源选择入口。
| 配置字段 | 填写方法 |
|---|---|
| 名称 | 例如“天地图卫星影像”，便于区分多个图源 |
| 类型 | 卫星底图选择“影像（底层）”；透明地名、道路注记选择“标记（顶层）” |
| XYZ 地址模板 | 必须包含 {z}、{x}、{y}，公网地址使用 HTTPS |
| 令牌环境变量（可选） | 填变量名，例如 TIANDITU_TOKEN；地址中的密钥位置使用 {token} |
| 版权标注 | 按服务方要求填写来源及版权信息 |
| 最大缩放级别 | 按获授权服务的级别设置；当前界面可选 18–22 |
| 显示 / 隐藏 | 开启后在地图中显示；暂时不用的图源可关闭 |
字段变更会应用到地图。打开地图并选中图源后才会请求瓦片，单纯打开本地文件不会自动申请位置或开通第三方服务。
当前接入方式是按 XYZ 编号请求栅格图片，不会自动解析 WMTS Capabilities、WMS、矢量瓦片或三维地形。WMTS 只有在投影、瓦片矩阵和编号兼容 XYZ 时，才能把固定 GetTile 请求改写成模板。地址中的占位符只支持 {z}、{x}、{y}、{token}，不能直接使用 {s}、{quadkey} 或 {-y}。
超过图源设置的最大级别时，应用拉伸最后一级瓦片，不会获得更高分辨率影像。若服务只授权到 18 级以下，当前设置范围无法准确表达该上限，应先向服务方确认兼容方案。
配置令牌环境变量
地址中保留 {token}，不要把真实 Key 或 Token 写进地址模板、项目文件或共享截图。三家服务可分别使用以下变量名：
| 服务 | 建议变量名 |
|---|---|
| 天地图 | TIANDITU_TOKEN |
| 吉林一号 | JL1_TOKEN |
| 星图云 | GEOVIS_TOKEN |
Windows：搜索“编辑账户的环境变量”，在用户变量中新增变量，将变量名填为上表名称、变量值填为自己申请的凭据。保存后完全退出并重新启动算青山。应用里填写的是变量名，不是变量值。
macOS / Linux：变量必须存在于启动算青山的进程环境中。仅在终端设置变量后，再从桌面图标启动应用，不一定能读取到它。可在同一终端设置变量并启动实际安装的可执行文件；不熟悉启动路径时请联系部署人员协助。不要用打印完整变量值的方式检查密钥。
天地图：注册、申请与使用
注册与申请 Key
- 打开天地图官网，注册或登录账户。
- 进入开发资源，按页面提示申请开发者资格及所需认证。
- 进入控制台，创建应用、申请服务许可 Key。说明实际用途是桌面软件访问地图瓦片，选择适用的应用类型及地图服务权限；不要为通过认证而虚填域名或 IP。
- 核对应用权限、来源限制和配额，复制自己的 Key，保存到
TIANDITU_TOKEN环境变量。
官方节点提供了开发资源与申请流程说明。国家开发资源页面在本次核对时访问受限，具体申请字段请以实际打开的控制台为准。
添加影像底图
以下为天地图常见 Web Mercator WMTS GetTile 地址的 XYZ 模板写法，供与官方服务说明核对后配置；不是账户连通性验证结果。
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={y}&TILECOL={x}&tk={token}
设置名称“天地图影像”，类型“影像（底层）”，令牌环境变量 TIANDITU_TOKEN。最大级别按官方服务和账户授权填写，不因应用能选 22 就填写 22。
需要地名注记时另建一个图源，将模板中的 img_w 改为 cia_w、LAYER=img 改为 LAYER=cia，类型选“标记（顶层）”，继续使用同一变量。底图与注记分别显示，避免地名被影像盖住。
这里的 w 指墨卡托瓦片矩阵；不要直接替换成经纬度矩阵 c。服务器编号在示例中固定为 t0，不要填应用不支持的子域名占位符。参数与当前可用级别以官方地图服务说明为准。
吉林一号：注册、申请与使用
申请在线影像服务
- 打开吉林一号网，从“登录”或“创建账户”注册、登录。
- 在官网进入“吉林一号在线地图访问”或“切片影像套件”的详情，明确申请在线地图/API 服务，而不是仅下载原始遥感数据。
- 根据所选产品要求完成个人或机构认证，确认影像年份、覆盖区域、访问额度、有效期及用途授权；需要订购或开通时按官方流程办理。
- 向产品页面或官方客服获取你所购服务的接入文档、瓦片地址、凭据和最大级别。官网展示的体验权益不应当作永久免费的 API 授权。
官网已公开介绍在线浏览与 API 调用服务，但本次未取得登录账户后的专属接入文档，因此不提供未经确认的通用吉林一号瓦片地址。
将取得的接口填入算青山
向服务方说明：需要 HTTPS、Web Mercator、兼容 XYZ 编号的栅格瓦片，鉴权凭据能放在请求 URL 中。取得实际地址后：
- 保留官方地址中的数据集、年份、区域和其他固定参数。
- 将缩放级别、列、行位置依次写为
{z}、{x}、{y}，不能只凭参数顺序猜测。 - 把凭据位置改成
{token}，将自己的凭据保存到JL1_TOKEN。 - 在算青山添加“吉林一号影像”，选“影像（底层）”，填写模板、变量名、版权标注和获授权级别。
- 到授权覆盖范围内查看影像，先检查少量瓦片，确认位置和清晰度正常。
如果官方交付的是仅支持 SDK、动态签名、请求头鉴权或需自动刷新 Token 的接口，当前图源表单不能直接接入；应向服务方申请兼容的瓦片服务或由部署人员提供获授权的适配服务。不要使用从他人网页中复制出来的共享令牌。
中科星图：注册、申请与使用
获取星图云 Token
按星图云官方接入指南：进入开放平台注册账户，完成个人或机构认证；在控制台确认所需影像服务权益，在“我的应用”创建应用，选择静态 Token 并获取凭据。将自己的 Token 存到 GEOVIS_TOKEN，不要把官方示例 Token 当作个人授权。
添加影像底图
根据官方指南的影像接口，将凭据替换为应用占位符：
https://api.open.geovisearth.com/map/v1/img/{z}/{x}/{y}?token={token}&format=webp&tmsIds=w
名称填“星图云影像”，类型选“影像（底层）”，令牌环境变量填 GEOVIS_TOKEN，按服务授权填写级别和版权标注。官方示例使用 WebP 与墨卡托参数 tmsIds=w，不要改为另一种投影后直接叠加地块。
影像产品、权益与地区覆盖可能不同，需在控制台确认 Token 获准调用该接口。星图旗下网站或其他产品的登录账号，不应直接当作本接口的 Token。
打开地块与叠加影像
保留 Shapefile 的同名 .shp、.shx、.dbf 和 .prj 文件，在项目里打开 .shp。底图只是位置背景，地块属性与边界仍来自你的本地资料。
当前应用仅在 .prj 可明确验证为 WGS 84 时叠加在线图源；缺少或不匹配时会暂停底图。CGCS2000、地方投影等数据不能靠改扩展名或重写坐标系名称解决，应先使用可靠工具完成实际坐标转换并核对位置。
配置多个图源时，可在地图的图源选择器切换；不需要的影像关掉，避免互相遮挡及额外请求。影像在本地矢量下方，透明注记在上方。
看不到卫星影像时
| 现象 | 检查事项 |
|---|---|
| 提示缺少占位符 | 模板是否包含 {z}、{x}、{y}，是否有不支持的变量 |
| 提示找不到环境变量 | 变量是否在启动应用的环境中设置，应用是否重启 |
| 认证失败或无权访问 | Key/Token、服务权限、配额、有效期、来源限制是否匹配 |
| 一直空白或返回非图片 | 是否误填官网、能力描述文档、SDK 地址或未授权接口 |
| 部分区域或级别空白 | 图源是否覆盖当前位置，缩放级别是否超出授权范围 |
| 地块与影像明显错位 | 瓦片矩阵、投影及 .prj 是否匹配；不要盲目偏移地块 |
| 显示“地图源已暂停” | 检查 .prj 是否明确标识 WGS 84 |
| 拉近后只有模糊像素 | 已达到源数据或所设最大级别，继续放大不会增加细节 |
拖动、缩放和切换图源都可能产生瓦片请求。保留来源标注，使用范围与缓存、导出许可按各服务方授权执行。软件免费与第三方影像服务费用是两回事，见费用说明。
地图功能以查看为主，不代表已具备拓扑编辑、自动面积核算、遥感解译或资源评估。AI 可用地理工具与地图界面是不同能力，不能把“能看影像”理解为“能自动完成空间分析”。