前言¶
做數據分析、運營報表或對話式助手時，常會碰到地址轉座標、附近 POI、路線耗時、天氣這類需求。自己拼 HTTP 請求要記一堆高德開放平臺接口與參數；讓模型「憑記憶」答地名和路線又容易不準。下面介紹 SkillHub 上的社區 Skill「高德地圖(qq9349540)」：把地理編碼、POI 搜索、路線規劃等能力寫進 Agent 的 SKILL 說明，在需要時按高德地圖 API 查詢中國境內的地理數據。
這是什麼¶
「高德地圖(qq9349540)」是 SkillHub 座標爲 @user_9cef7bd1/amap-qq9349540 的 Agent Skill，當前版本 v2.4.0，來源標註爲 community，發佈者爲 user_9cef7bd1，分類爲 data-analysis。官方頁面說明：當用戶需要地理編碼、POI 搜索、路線規劃（駕車/步行/騎行/公交）、座標轉換、天氣預報、批量操作或數據導出時，應使用此技能；底層依賴高德地圖 API，面向中國地理數據查詢場景。
核心功能¶
以下能力均來自 SkillHub 官方簡介，安裝並配置好密鑰後由 Agent 按 SKILL 指引調用：
- 地理編碼：地址與座標之間的轉換。
- POI 搜索：按關鍵詞或位置檢索興趣點。
- 路線規劃：支持駕車、步行、騎行、公交等出行方式。
- 座標轉換：在不同座標系之間轉換（常見於地圖與定位數據對齊）。
- 天氣預報：基於高德相關能力查詢天氣。
- 批量操作與數據導出：適合一次性處理多條地理查詢或整理結果。
SkillHub 標籤 requires_api_key=true，表示使用前需要自行準備高德開放平臺 API Key，並在 Skill 要求的配置方式中填寫（具體變量名以安裝後的 SKILL.md 爲準）。
安裝與啓用¶
方式一：讓 AI 按官方指引安裝¶
SkillHub 頁面給出的安裝提示如下，可將原文發給當前使用的 AI 客戶端執行：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_9cef7bd1/amap-qq9349540`。
方式二：SkillHub CLI¶
先確認本機是否已有 skillhub（參見 SkillHub 安裝文檔）。安裝技能時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，Agent 可能識別不到。
command -v skillhub && skillhub --version
skillhub install @user_9cef7bd1/amap-qq9349540 --dir <skills 目錄>
常用客戶端 skills 目錄示例（與官方安裝文檔一致）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝完成後按各客戶端要求刷新或重啓，使新 Skill 生效。高德 Key 需在 Skill 文檔說明的位置配置；未配置時帶 requires_api_key 的調用通常會失敗。
典型用法¶
本 Skill 以自然語言任務觸發爲主，Agent 在匹配到地理類需求時讀取 SKILL 並調用高德 API。可與官方簡介對齊的提問方向包括：
- 把「北京市朝陽區阜通東大街 6 號」做地理編碼，或把給定經緯度反查地址。
- 在某城市或某座標附近搜索 POI（例如加油站、地鐵站、商圈名稱）。
- 規劃從 A 到 B 的駕車、步行、騎行或公交路線，並比較耗時與距離。
- 對一批地址或座標做批量查詢，並將結果整理爲可導出的表格或文件（以 Skill 內支持的導出方式爲準）。
具體請求參數、子命令或腳本路徑以安裝包內 SKILL.md 爲準；本文不展開未在公開頁面列出的接口細節。
適用場景與注意¶
適合誰：需要在中國境內做地理信息查詢的開發者、數據分析師，或希望在 Cursor / Claude Code 等環境中用對話完成「查地點、算路線、拉天氣」的團隊。
使用注意：
- 依賴高德開放平臺賬號與 API Key，調用量、配額與計費以高德官方規則爲準。
- 數據覆蓋與精度以高德 API 返回爲準，不適合作爲唯一的高精度測繪或導航依據。
- 社區來源（community）Skill，升級與維護節奏跟隨發佈者；安裝前可在 SkillHub 查看版本 v2.4.0 及頁面上的評分、下載與安裝統計（頁面展示：評分 100000，下載 4668，安裝 98）。
結尾¶
「高德地圖(qq9349540)」把高德地圖 API 的常見能力收斂成一條 Agent Skill，減少手寫請求與記接口的成本，適合 data-analysis 場景下的地理數據查詢與導出。安裝與詳情見 SkillHub：
- 頁面：https://www.skillhub.cn/skills/user_9cef7bd1/amap-qq9349540
- API 入口（Skill 元數據）：https://api.skillhub.cn/user_9cef7bd1/amap-qq9349540
