Amap Search

高德地图全功能工具 - 集成POI搜索、路径规划、天气查询、公交查询、实时路况等。/Gaode Map All-in-One - POI search, route planning, weather, bus, traffic.

Security Scan

The skill appears to implement the advertised Amap/Gaode features and only calls Gaode APIs, but there are metadata and declaration inconsistencies you should review before installing.

Purpose & Capability

The code implements POI search, geocoding, reverse geocoding, routing, weather, traffic and related features using Gaode (restapi.amap.com) endpoints, which matches the skill description. However, registry metadata and in-repo metadata mismatch: SKILL.md/version and _meta.json show v2.x while the registry metadata shows v1.0.0; owner identifiers differ (registry owner id vs _meta.json owner 'mahongting'). These inconsistencies are not fatal but reduce trust in provenance.

Instruction Scope

SKILL.md instructs the agent/user to set AMAP_API_KEY (environment variable) or pass --key to the scripts and documents command usage. The runtime instructions stay within the claimed purpose (they only call Gaode Web Service APIs). Minor issue: metadata declares no required env vars while runtime docs and the scripts expect AMAP_API_KEY/--key; this is an omission that could confuse permissions/credential disclosures.

Install Mechanism

No install spec — instruction-only plus two Python scripts. No external binaries or downloads are requested by the skill manifest. This is low-risk by install mechanism standards.

Credentials

The skill requires a single service credential (Gaode API key) to operate, which is proportional to its purpose. But the skill manifest declares no required env vars/primary credential even though SKILL.md and the scripts require AMAP_API_KEY or --key; the missing declaration is an inconsistency worth noting.

Persistence & Privilege

always is false and there's no indication the skill requests persistent system privileges or modifies other skills or system configs. The skill is runnable as standalone Python scripts and does not request privileged placement.

Scan Findings in Context

[no_regex_findings] expected: Static pre-scan reported no injection signals or flagged patterns. The code performs network calls to restapi.amap.com only, which is expected for this skill.

What to consider before installing

This skill appears to implement the advertised Gaode/Amap features and only communicates with Gaode's REST endpoints, which is expected. Before installing or running it: 1) Verify the skill's provenance — metadata in the package (_meta.json, SKILL.md) and registry disagree on owner and version; prefer code from a trusted source or the author's repo. 2) Provide your own AMAP_API_KEY (do not use keys from others); prefer environment variable storage and avoid embedding keys in shared code or public registries. 3) Review the full scripts locally (there was truncation in the preview) to confirm there are no hidden endpoints or logging of your key. 4) Run the scripts in a sandboxed environment if you are unsure (they make outbound HTTPS calls). 5) If you need stronger assurance, ask the publisher for a canonical repository link or signed release and confirm the owner identity. These steps will reduce risk from provenance/metadata inconsistencies.

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

调用高德地图 Web 服务 API，提供完整的位置服务功能。

✨ 功能一览

命令	功能	说明
ip	IP定位	自动获取用户当前位置（精确到城市）
geo	地理编码	地址 → 经纬度坐标
regeo	逆地理编码	经纬度坐标 → 地址
poi	POI搜索	关键字搜索、周边搜索、城市搜索
route	路径规划	驾车、步行、公交路线规划
weather	天气查询	当前天气 + 未来预报
traffic	实时路况	城市/道路拥堵情况
tips	输入提示	智能自动补全建议

📋 快速开始 / 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: [phone]

周边搜索（带距离）

# 搜索附近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（如输入提示）可能需要企业认证，个人免费版可能无法使用。

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. 无担保：本技能按「原样」提供，不提供任何明示或暗示的担保。

使用本技能即表示您理解并同意上述免责声明。