← 返回 Skills 市场

高德地图 (Fangtian)

Name: 高德地图 (Fangtian)
Author: fangtianwd

作者 Fangtianwd · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

365

总下载

当前安装

版本数

在 OpenClaw 中安装

/install fangtian-amap

功能描述

高德地图 API 调用工具，返回原始 JSON 数据。Use when users ask about 天气、地址、坐标、周边、路线、导航、打车、行程 in China. Commands: weather, geo, regeo, search, around, detail, route, distance,...

使用说明 (SKILL.md)

高德地图技能

直接调用高德 REST API，返回完整 JSON 响应。支持 15 个 API，共 12 个命令。

安装

cp amap ~/.local/bin/
chmod +x ~/.local/bin/amap

环境变量

export AMAP_API_KEY="your-api-key"

获取 API Key: https://console.amap.com/dev/key/app （选择 Web服务）

命令列表（12个）

位置服务

命令	说明	示例
`weather`	天气查询	`amap weather 武汉`
`geo`	地址转坐标	`amap geo 黄鹤楼武汉`
`regeo`	坐标转地址	`amap regeo 114.3,30.6`
`ip`	IP定位	`amap ip 220.181.38.148`

搜索服务

命令	说明	示例
`search`	搜索地点	`amap search 黄鹤楼武汉`
`around`	周边搜索	`amap around 学校 114.3,30.6 3000`
`detail`	POI详情	`amap detail B001B0I4K0`

天气服务

命令	说明	示例
`weather`	天气查询	`amap weather 武汉`

路线规划

命令	说明	示例
`route`	路线规划	`amap route 114.3,30.6 114.4,30.7 driving`
`distance`	距离测量	`amap distance 114.3,30.6 114.4,30.7`

Schema 服务（生成 URI）

命令	说明	示例
`navi`	导航链接	`amap navi 114.3,30.6 黄鹤楼`
`taxi`	打车链接	`amap taxi 114.3,30.6 黄鹤楼 114.4,30.7`
`trip`	行程规划	`amap trip "武汉游" '[{"title":"Day1","points":[...]}]'`

输出格式

所有命令返回 JSON。

REST API 命令

返回高德 API 原始 JSON，包含 status、info、核心数据。

amap weather 武汉

{
  "status": "1",
  "forecasts": [{"city": "武汉市", ...}]
}

Schema 命令

返回 URI 链接，点击可直接唤醒高德地图 APP。

amap navi 114.30234,30.54489 黄鹤楼

{
  "status": "1",
  "uri": "https://uri.amap.com/marker?position=..."
}

调用示例

# 查天气
amap weather 武汉

# 地址转坐标
amap geo 黄鹤楼 武汉

# 搜索并获取详情
amap search 黄鹤楼 武汉
amap detail B001B0I4K0

# 周边搜索
amap around 学校 114.304569,30.593354 3000

# 路线规划
amap route 114.3,30.6 114.4,30.7 driving
amap route 114.3,30.6 114.4,30.7 walking

# 生成导航链接
amap navi 114.30234,30.54489 黄鹤楼

# 生成打车链接
amap taxi 114.30234,30.54489 黄鹤楼

解析示例

# 用 jq 解析
amap weather 武汉 | jq '.forecasts[0].casts'
amap geo 黄鹤楼 武汉 | jq '.geocodes[0].location'

# 用 Python 解析
amap search 黄鹤楼 | python3 -c "
import sys, json
data = json.load(sys.stdin)
for poi in data.get('pois', [])[:3]:
    print(poi['name'], poi['address'])
"

参数说明

坐标格式：经度,纬度（经度在前）
半径单位：米
路线方式：driving（驾车）、walking（步行）、cycling（骑行）、transit（公交）

注意事项

API Key 需要 Web服务权限
每日调用有限制
仅支持中国境内

安全使用建议

Do not install or run an unknown 'amap' binary from an unspecified source. Before proceeding, ask the publisher to: (1) include the actual executable or a trustworthy install URL (e.g., an official GitHub release) in the package; (2) update registry metadata to declare AMAP_API_KEY as a required env var; and (3) document exactly where the binary comes from and what it does. If you must use this skill: obtain the amap executable only from an official/verified source, inspect it (or its source code) before placing it in ~/.local/bin, and ensure the AMAP_API_KEY you provide has minimal necessary scope and is not tied to high-privilege accounts. Because the skill can be invoked autonomously by agents by default, prefer manual invocation until these inconsistencies are resolved.

功能分析

Type: OpenClaw Skill Name: fangtian-amap Version: 1.0.0 The skill bundle provides documentation and metadata for a tool that interfaces with the AMap (Gaode Maps) REST API. The SKILL.md file contains clear instructions for an AI agent to perform legitimate mapping tasks such as geocoding, weather queries, and route planning using the 'amap' command and standard system tools like curl. No evidence of malicious intent, data exfiltration, or prompt injection was found; the requested AMAP_API_KEY is a standard requirement for the described service.

能力评估

⚠ Purpose & Capability

The stated purpose (High German Amap/高德地图 API wrapper) legitimately needs an AMAP_API_KEY and uses curl — that is coherent. However, the skill registry metadata lists no required env vars or primary credential, which contradicts SKILL.md's explicit requirement for AMAP_API_KEY.

⚠ Instruction Scope

The SKILL.md tells the user/agent to 'cp amap ~/.local/bin/ && chmod +x' but this package contains no 'amap' binary or other code files. That instruction would cause an agent or user to place an external binary into their PATH; the origin of that binary is unspecified. Apart from that, the instructions only reference the AMAP_API_KEY and curl (reasonable for the stated purpose).

⚠ Install Mechanism

There is no formal install spec in the registry (instruction-only). Yet SKILL.md expects installing a local 'amap' executable — which is missing from the package. Because the binary is not provided, a user would need to obtain it from elsewhere (unknown source), which increases risk.

⚠ Credentials

The SKILL.md requires a single AMAP_API_KEY (appropriate and proportionate). The registry metadata, however, lists no required env vars or primary credential — a mismatch that could mislead users or automated installers about what secrets are needed. No unrelated credentials are requested.

✓ Persistence & Privilege

The skill does not request always:true, does not declare special config paths, and is instruction-only so it does not persist code on install. No elevated persistence or broad privileges are requested by the registry.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install fangtian-amap
安装完成后，直接呼叫该 Skill 的名称或使用 /fangtian-amap 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

首次发布：支持12个命令（天气、地理编码、搜索、路线规划、导航链接等）

元数据

Slug fangtian-amap

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题