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