Smart Map Guide 高德地图路线规划大师

高德地图路线规划与 POI 搜索。支持驾车、步行、骑行、公交路线规划，以及景点、餐厅搜索。当用户询问路线、行程规划、景点推荐、餐厅推荐时使用。

Security Scan

The skill's code, instructions, and requirements are consistent with a Gaode/AMap routing and POI helper; it needs an AMap API key stored in the included config file and makes outbound requests to AMap endpoints.

Purpose & Capability

Name/description (AMap routing & POI) align with the included Python scripts that call restapi.amap.com. One minor inconsistency: registry metadata lists no required config paths, but SKILL.md instructs the user to edit skills/map/scripts/config.json to supply the AMap API key (the code expects that file). This is not malicious but is an omission in metadata.

Instruction Scope

SKILL.md and the CLI examples only describe editing the local config.json and running the provided Python scripts. The runtime instructions do not ask the agent to read unrelated system files or environment variables; they only require the AMap API key placed in the skill's config file and perform network calls to AMap endpoints.

Install Mechanism

There is no install spec (instruction-only skill with included Python files). The code depends on the 'requests' library but the skill provides no installer; the runtime environment must already have Python and requests available. No downloads from arbitrary URLs or extracted archives are present.

Credentials

No environment variables or unrelated credentials are requested. The only secret required is the AMap API key, which the SKILL.md directs the user to place into scripts/config.json. Storing a service API key in a local file is reasonable for this use, but the metadata did not declare this config requirement.

Persistence & Privilege

The skill is not marked 'always' and does not request elevated or persistent system privileges. It does not modify other skills or system configuration. Autonomous invocation is permitted (platform default) but not in combination with other concerning behaviors.

Assessment

This skill appears to do what it claims: call AMap (高德) APIs for routing and POI searches. Before installing, note: (1) you must populate skills/map/scripts/config.json with your AMap API key — the registry metadata omitted this config path. (2) The Python scripts use the 'requests' library; ensure Python and requests are available in your environment. (3) The skill will send queries (including the API key) to restapi.amap.com — treat the API key as a secret, store it securely, and limit its permissions/quota on the AMap console. (4) Review the included scripts if you need absolute assurance (they appear to call only AMap endpoints and do not access other system files). If you are uncomfortable storing the API key in a file, consider providing it through a more secure mechanism or rotating the key frequently.

地图路线规划与 POI 搜索

基于高德地图 API 的路线规划和 POI 搜索服务。

配置

编辑 skills/map/scripts/config.json，填写高德地图 API Key（从官网申请 https://lbs.amap.com/）：

{
  "amap_key": "YOUR_AMAP_API KEY"
}

AI 调用示例

用户说"我想去东莞玩3天"：

# 1. 搜索景点
python3 skills/map/scripts/map.py attractions --city 东莞 --page-size 20 --json

# 2. 查询景点间路线
python3 skills/map/scripts/map.py driving --origin "旗峰公园" --destination "可园博物馆" --origin-city 东莞 --dest-city 东莞

用户说"东莞有什么好吃的"：

python3 skills/map/scripts/map.py restaurants --city 东莞 --page-size 20 --json

用户说"从天安门到鸟巢坐地铁怎么走"：

python3 skills/map/scripts/map.py transit --origin "天安门" --destination "鸟巢" --city1 010 --city2 010

命令行参考

路线规划

# 驾车
python3 skills/map/scripts/map.py driving --origin "起点" --destination "终点" --origin-city 城市 --dest-city 城市

# 步行
python3 skills/map/scripts/map.py walking --origin "起点" --destination "终点" --origin-city 城市 --dest-city 城市

# 公交（需要城市编码）
python3 skills/map/scripts/map.py transit --origin "起点" --destination "终点" --city1 编码 --city2 编码

# 显示详细步骤
python3 skills/map/scripts/map.py driving --origin "起点" --destination "终点" --show-steps

POI 搜索

# 景点搜索（风景名胜 + 博物馆）
python3 skills/map/scripts/map.py attractions --city 城市 --page-size 20

# 餐厅搜索（排除快餐）
python3 skills/map/scripts/map.py restaurants --city 城市 --page-size 20

# 通用搜索
python3 skills/map/scripts/map.py search --keywords 关键词 --city 城市

常用城市编码

城市	编码	城市	编码
北京	010	上海	021
广州	020	深圳	0755
东莞	0769	杭州	0571

注意事项

• 支持地址名称或经纬度坐标作为起终点，系统自动识别
• 建议提供城市参数以提高地址解析准确性
• 公交路线必须提供城市编码
• 所有搜索命令支持 --json 输出