← Back to Skills Marketplace
fangtianwd

高德地图 (Fangtian)

by Fangtianwd · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
365
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install fangtian-amap
Description
高德地图 API 调用工具,返回原始 JSON 数据。Use when users ask about 天气、地址、坐标、周边、路线、导航、打车、行程 in China. Commands: weather, geo, regeo, search, around, detail, route, distance,...
README (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服务 权限
  • 每日调用有限制
  • 仅支持中国境内
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install fangtian-amap
  3. After installation, invoke the skill by name or use /fangtian-amap
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
首次发布:支持12个命令(天气、地理编码、搜索、路线规划、导航链接等)
Metadata
Slug fangtian-amap
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 高德地图 (Fangtian)?

高德地图 API 调用工具,返回原始 JSON 数据。Use when users ask about 天气、地址、坐标、周边、路线、导航、打车、行程 in China. Commands: weather, geo, regeo, search, around, detail, route, distance,... It is an AI Agent Skill for Claude Code / OpenClaw, with 365 downloads so far.

How do I install 高德地图 (Fangtian)?

Run "/install fangtian-amap" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 高德地图 (Fangtian) free?

Yes, 高德地图 (Fangtian) is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 高德地图 (Fangtian) support?

高德地图 (Fangtian) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 高德地图 (Fangtian)?

It is built and maintained by Fangtianwd (@fangtianwd); the current version is v1.0.0.

💬 Comments