---

name: amap description: '高德地图 API 调用工具，返回原始 JSON 数据。Use when users ask about 天气、地址、坐标、周边、路线、导航、打车、行程 in China. Commands: weather, geo, regeo, search, around, detail, route, distance, ip, navi, taxi, trip.' compatibility: Requires curl (system built-in) and AMAP_API_KEY environment variable.

高德地图技能

直接调用高德 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服务 权限
• 每日调用有限制
• 仅支持中国境内