# 高德地图 Key 使用指南（FS 旅行者 / FS Voyager）

## 一、先说结论：不填 Key 也能用

FS 旅行者内置了数万条**离线地名库**（全国省 / 市 / 区县、4A·5A 景区、全球知名地标、主要城市等）。
像「北京CBD」「中国尊」「西湖」「故宫」这类地点，直接输入就能定位——**不需要联网、不需要任何 Key**。

模拟飞行要的是“大概地点”，离线库已经够用；只有想搜更细的国内地点（某小区、某商场、某具体建筑）时，才需要你自己的高德 Key。

## 二、为什么要自己申请 Key（而不是作者替你填）

- 高德 Key 关联调用额度与计费，属于你的个人账户资产；
- 作者把 Key 打包进程序，既违背 MIT 开源精神，也会让用户替作者承担调用风险；
- 因此从 **v0.83 起**，高德 Key 改为**用户自填**，程序本身不再内置任何第三方密钥。

## 三、如何获取高德 Key（约 5 分钟，免费）

1. 打开高德开放平台官网 <https://lbs.amap.com/> ，用手机号注册并登录。
2. 进入「应用管理 → 我的应用」<https://console.amap.com/dev/key/app> ，点「创建应用」，随便起个名字（如“FS 旅行者”），应用类型选「其他」。
3. 在该应用下点「添加 Key」：
   - **服务平台必须选「Web 服务」**（选“Web 端(JS API)”“安卓”等其他类型都会调不通）；
   - 名称随便填，提交。
4. 创建完成后，在 Key 列表里会看到一串字母数字组成的 Key 字符串，**复制它**即可。

> 提示：高德「Web 服务」Key 有每日免费调用配额（个人开发者通常 3000 次/日），普通飞行定位完全够用；注意别把 Key 泄露给别人。

## 四、如何把 Key 交给 FS 旅行者（两种方式任选其一）

**方式 A：放文件（最简单，推荐）**

1. 新建一个纯文本文件，文件名叫 `amap_key.txt`（注意**没有**别的后缀）；
2. 文件里**只写一行**：粘贴你的高德 Key，不要加空格、引号或多余换行；
3. 把这个 `amap_key.txt` 放到 **FSVoyager.exe 同一个文件夹**里（就是 exe 旁边）；
4. 重启 FS 旅行者即可生效。

**方式 B：设环境变量**

- Windows：设置 → 系统 → 关于 → 高级系统设置 → 环境变量，新建一个**用户变量** `AMAP_KEY`，值填你的 Key，确定后重启程序。
- 两种方式同时存在时，**环境变量优先**于文件。

## 五、验证是否生效

打开 FS 旅行者，搜索一个比较细的国内地点（例如「世纪金源大酒店」）。若能搜到并定位，说明 Key 已生效；
若搜不到、但「北京CBD」这类仍能搜到，说明仍在用离线库（Key 未生效，请按下方排查）。

## 六、常见问题

- **填了 Key 还是搜不到？** 依次检查：
  ① 文件名必须严格是 `amap_key.txt`，不是 `amap_key.txt.txt`（资源管理器默认隐藏后缀，可在「查看」里勾选“文件扩展名”核对）；
  ② 文件要在 FSVoyager.exe 同目录；
  ③ Key 的服务平台是否选错（必须“Web 服务”）；
  ④ 是否重启了程序。
- **Key 安全**：`amap_key.txt` 里是你的私人密钥，请勿随意外传；程序只在你本机用于联网检索，不会上传给任何人。
- **不想用了？** 删除 `amap_key.txt` 或清空环境变量即可，程序自动退回离线库 + 国际源，功能不受影响。

---

*FS 旅行者（FS Voyager）· 作者 JerryXiao · 采用 MIT 协议*
