> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superun.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 高德地图

> 配置高德地图能力，为应用接入地图、地理编码和地点搜索等功能。

## 这是什么

「高德地图」是基于高德地图平台的插件，可以为你的应用添加交互式地图、地理编码、逆地理编码、地点搜索和路线规划等功能。

插件按项目独立启用。你可以使用平台测试 Key 先做体验，或切换到自己的高德应用 Key 用于线上生产环境。

***

## 入口位置

1. 进入任意项目。
2. 顶部切换到 **「研发」** Tab。
3. 左侧导航选择 **「技能库」**。
4. 在卡片列表中找到 **「高德地图」**。

***

## 启用

以下任一方式都可以启用：

* 在技能库卡片上悬停，点击 **「使用」**。
* 打开插件详情页，在头部点击 **「使用」**。
* 当 AI 在对话中主动弹出插件启用卡片时，点击确认。

启用后，请在插件详情页配置高德 Key。

***

## 配置

启用后进入插件详情页，有两种模式可选：

### 平台测试 Key

三项 Key 全部留空即可使用内置的平台测试 Key。额度有限，不建议直接用于线上。

### 自己的高德应用 Key

在高德开放平台控制台获取三项 Key 并填写：

* **Web 服务 Key**：用于地理编码、逆地理编码、地点搜索、路线规划等服务调用。
* **JS API Key**：用于浏览器地图 SDK、地图选点、前端交互式地图展示。
* **安全密钥**：用于 JS API 2.0 的 securityJsCode，或已开启 referer / 安全校验的场景。

使用自己的 Key 时，三项必须一起填写。填写完成后点击 **「保存配置」** 即可生效。

要从自己的 Key 切回平台测试 Key，请在详情页使用 **「恢复平台默认」** 功能。

***

## 停用

进入插件详情页，点击头部 **「停用」**，在确认弹窗中确认即可。

***

## 常见问题

<AccordionGroup>
  <Accordion title="可以同时使用自己的 Key 和平台测试 Key 吗？">
    不可以。要么三项全空用平台测试 Key，要么三项都填用你自己的 Key。不支持混合填写。
  </Accordion>

  <Accordion title="这个插件覆盖高德的哪些服务？">
    主要覆盖 Web 服务 API（地理编码、地点搜索、路线规划）和 JS API（浏览器地图、地图选点）。其他高德服务可能需要额外配置。
  </Accordion>
</AccordionGroup>