AIGC: ContentProducer: Minimax Agent AI ContentPropagator: Minimax Agent AI Label: AIGC ProduceID: 419f142dffc2786f70c781514aae295d PropagateID: 419f142dffc2786f70c781514aae295d ReservedCode1: 3045022100f0a82fe3f70a96ea776cd6f5eb99567be33ce61f08fa12f0e0a9bfb962f853b50220795b188df61cf38c33d2c6326e01946a47ab16c9efc3c5e8195794683bef4a72 ReservedCode2: 30460221009b63253a328bf0551118bab8d26be628665ca7933d06e030f81d5bb83dc879a2022100aab0156baa6ad550357ea8aee375d5211026970299e2fcc89a93df76a1673d21 description: 高德地圖全功能工具 - 整合POI搜尋、路徑規劃、天氣查詢、公交查詢、即時路況等。/Gaode Map All-in-One - POI search, route planning, weather, bus, traffic. icon: "\U0001F5FA️" name: amap-search version: 2.0.0

🗺️ 高德地圖全功能工具 (amap-search)

呼叫高德地圖 Web 服務 API，提供完整的位置服務功能。

✨ 功能一覽

📋 快速開始 / Quick Start

第一步：申請高德 API Key

1. 訪問 高德開放平臺：https://lbs.amap.com/
2. 點選「註冊/登入」→ 使用賬號登入
3. 進入「控制台」→ 「應用管理」→ 「建立應用」
4. 應用名稱：高德地圖工具（任意名稱）
5. 點選「新增 Key」→ 填寫 Key 名稱
6. 服務平臺：勾選 「Web服務」
7. 點選「提交」，獲取 Key

💡 免費額度：每個 Key 每天 2000 次呼叫，個人使用足夠

第二步：配置 API Key（推薦使用環境變數）

方式一：設定環境變數（推薦）

# 在終端中設定環境變數
export AMAP_API_KEY="你的API_KEY"

# 或在 ~/.bashrc 中永久新增
echo 'export AMAP_API_KEY="你的API_KEY"' >> ~/.bashrc
source ~/.bashrc

方式二：命令列引數

python3 gaode_map.py <命令> --key 你的API_KEY [引數]

⚠️ 優先順序：環境變數 > 命令列引數。建議使用環境變數，避免每次輸入。

📖 詳細使用說明

1️⃣ IP定位 (ip)

獲取使用者當前所在城市。

python3 gaode_map.py ip --key 你的KEY

輸出示例：

Your location: 四川省 成都市
City code: 510100

2️⃣ 地理編碼 (geo)

將地址轉換為經緯度座標。

# 基本用法
python3 gaode_map.py geo --key 你的KEY --address "成都市天府廣場"

# 指定城市（更精確）
python3 gaode_map.py geo --key 你的KEY --address "春熙路" --city 成都

輸出示例：

Address: 四川省成都市錦江區春熙路
Location: 104.085329,30.658137

3️⃣ 逆地理編碼 (regeo)

將經緯度座標轉換為地址。

python3 gaode_map.py regeo --key 你的KEY --location "104.085329,30.658137"

4️⃣ POI 搜尋 (poi)

搜尋附近的商家、服務設施。

按城市關鍵字搜尋

python3 gaode_map.py poi --key 你的KEY --city 成都 --keyword "火鍋"

周邊搜尋（指定位置附近）

python3 gaode_map.py poi --key 你的KEY --location "104.085,30.658" --radius 3000 --keyword "餐廳"

輸出示例：

Found 21 results:

1. 蜀九香火鍋(春熙路店)
   Address: 錦江區春熙路南段8號
   Location: 104.085123,30.657891
   Phone: 028-86612345

周邊搜尋（帶距離）

# 搜尋附近POI並顯示每個結果到起點的實際駕駛距離
python3 gaode_map.py poi --location "104.069,30.229" --radius 2000 --keyword "酒店" --with-distance

輸出示例：

Found 10 results:

1. 樂遊酒店 | 地址：視高街道xxx | 距離：313米
2. 橙葦公寓 | 地址：xxx | 距離：853米
...

5️⃣ 路徑規劃 (route)

規劃出行路線。

駕車路線

python3 gaode_map.py route --key 你的KEY \
  --origin "104.065,30.657" \
  --destination "104.085,30.675" \
  --mode driving

步行路線

python3 gaode_map.py route --key 你的KEY \
  --origin "104.065,30.657" \
  --destination "104.085,30.675" \
  --mode walking

公交/地鐵路線

python3 gaode_map.py route --key 你的KEY \
  --origin "104.065,30.657" \
  --destination "104.085,30.675" \
  --mode transit \
  --city 成都

輸出示例：

Distance: 3418 meters
Duration: 828 seconds (約14分鐘)
Steps (12):
  1. 向南行駛23米右轉
  2. 向西行駛46米左轉
  ...

6️⃣ 天氣查詢 (weather)

查詢天氣資訊。

當前天氣

python3 gaode_map.py weather --key 你的KEY --city 成都

天氣預報（包含未來幾天）

python3 gaode_map.py weather --key 你的KEY --city 成都 --forecast

輸出示例：

City: 成都市
Weather: 陰
Temperature: 15°C
Wind: 北風 ≤3級
Humidity: 79%

Forecast:
  2026-03-12: 陰/多雲, 12°C ~ 18°C
  2026-03-13: 小雨/陰, 10°C ~ 15°C

7️⃣ 即時路況 (traffic)

查詢道路交通狀況。

城市整體路況

python3 gaode_map.py traffic --key 你的KEY --city 成都

特定道路路況

python3 gaode_map.py traffic --key 你的KEY --city 成都 --road "天府大道"

8️⃣ 輸入提示 (tips)

智慧自動補全，輸入關鍵詞時給出建議。

python3 gaode_map.py tips --key 你的KEY --keyword "春熙" --city 成都

📊 JSON 輸出

所有命令都支援 --json 引數，輸出 JSON 格式，方便程式處理：

python3 gaode_map.py weather --key 你的KEY --city 成都 --json

⚠️ 注意事項

1. API Key 必需：每個使用者需要自己申請高德 API Key
2. 呼叫限制：免費版每天 2000 次，大部分場景足夠
3. 座標格式：經度在前，緯度在後（如 104.065,30.657，不是 30.657,104.065）
4. 城市引數：部分 API 需要城市名稱或城市程式碼

🔧 常見問題

Q: 為什麼提示 "SERVICE_NOT_AVAILABLE"？ A: 部分 API（如輸入提示）可能需要企業認證，個人免費版可能無法使用。

更多技能請訪問小蔥技能站7w4.net。

Q: 如何獲取經緯度？ A: 使用 geo 命令，將地址轉換為座標。

Q: 路徑規劃支援哪些方式？ A: 駕車(driving)、步行(walking)、公交(transit)三種方式。

📝 更新日誌

• v2.1.0: 新增 --with-distance 引數，POI搜尋時顯示每個結果的距離
• v2.0.0: 新增路徑規劃、天氣查詢、即時路況、輸入提示功能
• v1.0.0: 初始版本，包含 IP定位、地理編碼、POI搜尋

📞 支援

• 高德開放平臺：https://lbs.amap.com/
• OpenClaw 社群：https://clawd.org.cn/

⚠️ 免責宣告

本技能僅供學習交流使用，免費提供，不收取任何費用。

1. 資料準確性：本工具依賴高德開放平臺 API，返回的資料由高德提供，我們不對資料的準確性、完整性、及時性做任何保證。

2. 使用風險：因使用本技能導致的任何直接或間接損失（包括但不限於商業損失、資料丟失、時間損失），我們不承擔任何責任。

3. API 穩定性：高德 API 可能存在服務不穩定、呼叫限制、介面變更等情況，可能導致功能不可用。

4. 使用者責任：使用者需自行確保 API Key 的安全妥善使用，遵守高德開放平臺的服務條款。

5. 無擔保：本技能按「原樣」提供，不提供任何明示或暗示的擔保。

使用本技能即表示您理解並同意上述免責宣告。

這是一款功能豐富、文件詳盡的高德地圖工具，可滿足日常位置查詢需求。文件清晰易懂，功能說明和示例都很全面，配置API Key的方式也很靈活。程式碼實現了重試機制，使用起來比較穩定。不過需要使用者自行申請高德API Key，對技術小白有一定門檻。總體來說質量可靠，是一款實用性強的小工具。