前言¶

後端或腳本里要接位置能力時，常見路徑是翻騰訊位置服務文檔、對照參數表拼 URL，再處理 JSON 返回與座標系差異。地圖 SDK 和 WebService 的職責也不同：前者管展示，後者只管數據。若你只需要地理編碼、POI 搜索、路線規劃等 HTTP JSON 接口，又希望對話式開發時少漏參數、少混接口，可以把官方能力封裝成 Agent Skill，讓模型按既定指引組織調用。

下面介紹 SkillHub 上的 騰訊地圖 WebService API 開發技能（座標 @tencent-adm/tencentmap-webservice-skill，當前版本 1.0.5），由 騰訊地圖位置服務團隊 發佈，來源標註爲 enterprise，分類爲 dev-programming。

這是什麼¶

一句話：面向 騰訊位置服務 WebService API 的開發技能，通過 HTTP 集成地理編碼、地點搜索、路線規劃、天氣、IP 定位等能力，不包含地圖渲染與前端可視化，只覆蓋 WebService 的 JSON 數據接口。

在 SkillHub 上，該技能帶有 requires_api_key=true 標籤，表示實際調用騰訊接口時需要有效的位置服務密鑰；密鑰申請與控制台配置仍以騰訊位置服務官方流程爲準，技能側負責在對話中引導正確的 API 選擇與參數用法。

核心功能¶

以下能力與 SkillHub 頁面簡介一致，均對應 WebService 側能力，而非地圖組件：

1. 地址與座標互轉：地理編碼、逆地址解析、智能地址解析。
2. 地點與 POI：地點搜索、周邊 POI 查詢。
3. 輸入體驗：關鍵詞輸入提示、自動補全。
4. 路線規劃：駕車、步行、騎行、電動車、公交等模式。
5. 距離計算：距離矩陣、批量距離。
6. 定位與氣象：IP 定位、天氣查詢。
7. 基礎數據：座標系轉換、行政區劃查詢。

技能會在用戶提到地理編碼、地址轉座標、逆地址解析、POI 搜索、路線規劃、距離矩陣、批量距離、天氣查詢、IP 定位、座標轉換、行政區劃、輸入提示、自動補全、WebService API 等表述時觸發，把對話引向對應的接口說明與調用步驟。

安裝與啓用¶

方式一：SkillHub CLI¶

先確認本機是否已安裝 skillhub（安裝方式見 SkillHub 安裝文檔）。安裝技能時 必須 使用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認落在 ./skills/ 可能不會被加載。

skillhub install @tencent-adm/tencentmap-webservice-skill --dir <你的 Agent skills 目錄>

常用目錄示例（以安裝文檔爲準）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

安裝後按你所用客戶端的要求刷新或重啓 Agent，使技能被索引。

方式二：讓 AI 按官方指引安裝¶

SkillHub 頁面提供的提示詞爲：根據 https://skillhub.cn/install/skillhub.md 安裝 @tencent-adm/tencentmap-webservice-skill。適合尚未配置 CLI、但已在對話中啓用 Skill 安裝能力的環境。

典型用法¶

技能本體爲通用 SKILL.md 格式，不替代騰訊控制台，而是在開發對話中補齊「選哪個接口、參數怎麼填、返回字段如何理解」的上下文。可復現的啓用方式如下。

安裝後，用自然語言描述 WebService 需求，與官方列出的觸發詞一致即可，例如：

• 「把『北京市海淀區中關村大街 1 號』做地理編碼，用騰訊 WebService。」
• 「兩點駕車路線規劃，輸出 JSON 字段說明。」
• 「批量算多個起點到同一終點的距離矩陣，接口和參數怎麼傳？」

Agent 加載 @tencent-adm/tencentmap-webservice-skill 後，應依據技能內文檔組織 HTTP 請求說明（路徑、必填參數、座標系注意事項等），而不是生成地圖頁面或小程序 map 組件代碼。若同一項目還要做小程序地圖展示，需另選面向前端的地圖類技能；WebService 技能只覆蓋後端 HTTP 數據層。

適用場景與注意¶

適合誰

• 用 Cursor、Claude Code、Codex 等帶 Skills 的 Agent 寫後端、腳本或集成服務的開發者。
• 已確定使用騰訊位置服務 WebService，不需要在本技能內解決瓦片、標註、可視化的問題。

邊界與注意

• 僅 HTTP JSON：不涉及地圖渲染；前端展示需用地圖 SDK 或其他技能。
• 需要 API Key：標籤 requires_api_key=true；未配置密鑰時，技能無法替代真實聯調，只能做參數與文檔層面的輔助。
• 與小程序地圖分工：小程序內 map 組件、選點定位等場景，SkillHub 生態中有單獨的地圖小程序類技能；本技能對應「後端 HTTP：路線、POI、地理編碼、距離矩陣、IP 定位」一類需求。

在 SkillHub 統計上（以頁面抓取爲準），該技能評分 100000，下載 3250，安裝 47；具體數字會隨平臺更新變化，以 SkillHub 詳情頁爲準。

結尾¶

若你的工作流是「Agent 寫代碼 + 騰訊位置服務 WebService」，該技能把官方能力清單和觸發場景收斂進 SKILL，減少在多種路線/搜索/編碼接口之間來回查文檔的成本。安裝與詳情見：

• API 入口：https://api.skillhub.cn/tencent-adm/tencentmap-webservice-skill
• SkillHub 頁面：https://www.skillhub.cn/skills/tencent-adm/tencentmap-webservice-skill