> ## 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>