← 返回 Skills 市场
ttguy0707

amap-location

作者 ttguy0707 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
249
总下载
1
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install amap-location
功能描述
高德地图服务(路径规划、POI 搜索)
使用说明 (SKILL.md)

AMap Location - 高德地图服务

提供路径规划、POI 搜索、地理编码等高德地图服务。

配置

API Key

已存储在 /home/thor/.openclaw/settings/amap.env

export AMAP_API_KEY="your_api_key"

加载环境变量

source /home/thor/.openclaw/settings/amap.env

功能

🗺️ 静态地图(推荐)

搜索并生成带标记的地图

amap-map-search "汉堡" "23.155254,113.346322" 3 1500
  • 自动生成高清地图(1024x1024)
  • 红点 A 标记您的位置
  • 蓝点 B/C/D 标记搜索结果
  • 自动发送并清理临时文件

📍 地理编码

地址 → 坐标

amap geocode --address="广州市天河区体育西路 100 号"

🏠 逆地理编码

坐标 → 地址

amap regeocode --location="113.346322,23.155254"

🚗 驾车路径规划

amap driving --origin="113.346322,23.155254" --destination="113.264434,23.129018"

🚶 步行路径规划

amap walking --origin="113.346322,23.155254" --destination="113.350000,23.160000"

🚌 公交路径规划

amap transit --origin="113.346322,23.155254" --destination="113.264434,23.129018"

🔍 POI 搜索

搜索美食

amap search --keywords="美食" --location="113.346322,23.155254" --radius=1000

搜索酒店

amap search --keywords="酒店" --location="113.346322,23.155254" --radius=2000

搜索加油站

amap search --keywords="加油站" --location="113.346322,23.155254" --types="加油站" --radius=3000

使用方式

方式 1:命令行

# 加载环境变量
source /home/thor/.openclaw/settings/amap.env

# 使用命令
amap driving --origin="起点坐标" --destination="终点坐标"

方式 2:直接跟我说

发送位置信息后,我会询问您想要:

  • 🚗 路径规划(驾车/步行/公交)
  • 🍽️ 搜索美食
  • 🏨 搜索酒店
  • ⛽ 搜索加油站
  • 🏥 搜索医院
  • 其他 POI 搜索

方式 3:包装脚本

# 搜索附近美食
amap-search-food "113.346322,23.155254"

# 规划驾车路线
amap-drive "起点坐标" "终点坐标"

POI 类型参考

类型 关键词 types 代码
美食 美食、餐厅 餐饮服务
酒店 酒店、宾馆 住宿服务
加油站 加油站 加油站
医院 医院 医疗保健服务
银行 银行 金融服务
购物 购物、商场 购物服务
景点 景点、公园 风景名胜

示例

# 查询地址坐标
amap geocode --address="广州塔"

# 规划从当前位置到广州塔的驾车路线
amap driving --origin="113.346322,23.155254" --destination="113.325610,23.106500"

# 搜索附近 1 公里内的美食
amap search --keywords="美食" --location="113.346322,23.155254" --radius=1000

API 限制

  • 每日配额:根据 API Key 等级
  • 并发限制:避免高频请求
  • 超时设置:10 秒
安全使用建议
This skill appears to implement legitimate AMap API usage but contains several mismatches you should address before installing: - The Python files require AMAP_API_KEY, but the skill metadata declares no required env vars. Do not provide other secrets; only supply an AMap API key with minimal permissions/quota. - SKILL.md tells you to source a hard-coded path (/home/thor/.openclaw/settings/amap.env). That path is user-specific and may not exist — prefer placing your key in a controlled location and set AMAP_API_KEY in the environment explicitly. - SKILL.md references wrapper commands (amap-map-search, amap-search-food, amap-drive, etc.) and claims auto-send/cleanup behavior that are not present in the included scripts. Expect to run the provided Python commands (amap.py static map via static_map.py) instead. Verify any wrappers or automation before trusting them. - The static map generator writes to /tmp by default and prints the file path; it does not appear to exfiltrate data. Still, run the skill in an isolated environment (or container) if you are concerned about network access or accidental exposure of your API key. If you want to proceed: set AMAP_API_KEY in your environment (or use a dedicated key with restricted quota), inspect and test the included Python scripts locally, and consider requesting the maintainer update the skill metadata and SKILL.md to accurately declare the required env var and correct CLI examples. If you cannot verify the source/maintainer, avoid deploying the skill in sensitive environments.
功能分析
Type: OpenClaw Skill Name: amap-location Version: 1.0.0 The skill bundle provides legitimate integration with AMap (AutoNavi) services for geocoding, route planning, and POI searching. The Python scripts (amap.py and static_map.py) use standard libraries to interact with official AMap API endpoints and utilize Pillow for image processing, with no evidence of data exfiltration, command injection, or malicious intent.
能力评估
Purpose & Capability
The Python code implements geocoding, routing, POI search and static map generation — which matches the skill name/description. However the package metadata claims no required env vars while both code files require AMAP_API_KEY. SKILL.md also references wrapper scripts (e.g., amap-map-search, amap-search-food, amap-drive) that are not present in the bundle. These inconsistencies mean the declared metadata does not fully reflect the skill's real needs.
Instruction Scope
SKILL.md instructs the agent/user to source a specific file path (/home/thor/.openclaw/settings/amap.env) for the API key and claims features like "自动发送并清理临时文件" that the included scripts do not perform. It gives CLI examples that do not correspond exactly to the provided Python entrypoints. The instructions therefore assume specific filesystem layout and extra helper scripts that are not included — scope creep and mismatched guidance.
Install Mechanism
There is no install spec (instruction-only), and the bundle contains only two Python files plus SKILL.md. No external downloads or package installs are performed by the skill itself. This is low-risk from an install-download perspective.
Credentials
Although the functionality legitimately requires an AMap API key, the skill metadata lists no required environment variables or primary credential while both amap.py and static_map.py exit if AMAP_API_KEY is not set. SKILL.md suggests storing the key in a hard-coded user path (/home/thor/.openclaw/settings/amap.env). Asking users to place secrets in a specific home path and failing to declare the required env var in metadata is disproportionate and brittle.
Persistence & Privilege
The skill does not request persistent/always-on privileges, does not modify other skills or system-wide configs, and does not require elevated privileges. It reads an environment variable and writes a temporary PNG (defaults to /tmp/static_map.png).
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install amap-location
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /amap-location 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of amap-location skill. - 提供高德地图路径规划(驾车、步行、公交)、POI 搜索、地理编码、逆地理编码等功能 - 支持命令行调用和自动化包装脚本 - 可生成带标记的静态地图图片 - 环境变量配置简单,便于集成和扩展 - 包含常见 POI 类型参考和用法示例 - 详述 API 使用方法及配额限制
元数据
Slug amap-location
版本 1.0.0
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 1
常见问题

amap-location 是什么?

高德地图服务(路径规划、POI 搜索). 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 249 次。

如何安装 amap-location?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install amap-location」即可一键安装,无需额外配置。

amap-location 是免费的吗?

是的,amap-location 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

amap-location 支持哪些平台?

amap-location 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 amap-location?

由 ttguy0707(@ttguy0707)开发并维护,当前版本 v1.0.0。

💬 留言讨论