360 Secure SkillHub
360 安全技能中心

高德地图

通过高德地图 Web 服务 API 做地理编码与路径规划：输入出发地、目的地和可选出行方式（骑行/驾车/步行），返回距离、预计时间与途经路线节点。需配置 AMAP_API_KEY，实际调用由 shell 脚本结合 curl 与 python3 完成。

lanlan314
lanlan314
热度 38.03
最近更新 2026-08-31 23:30:45
分类：生活依赖：代码执行 / 第三方 API / 读写文件应用场景：旅行

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add lanlan314/amap
Metadata
name
amap
description
高德地图 API 技能，支持路径规划、距离计算、地理位置搜索等。用于查询两地之间的骑行/驾车/步行路线、距离、时间等实时信息。需要配置高德地图 API Key（AMAP_API_KEY）。

高德地图技能 (amap)

⚠️ 环境变量配置

环境变量 说明 获取方式
AMAP_API_KEY 高德地图 Web 服务 API 密钥 高德开放平台控制台

配置步骤

  1. 注册/登录高德开放平台：https://console.amap.com
  2. 创建应用，获取 Web 服务 API Key
  3. 在 ~/.openclaw/credentials/ 下创建 amap.json，格式如下：
{
  "amap": {
    "api_key": "你的API Key"
  }
}

API 端点

  • 路径规划：https://restapi.amap.com/v3/direction/:type
  • 地理编码：https://restapi.amap.com/v3/geocode/geo
  • 距离测量：https://restapi.amap.com/v3/distance

支持的出行方式（type）

type 说明
bicycling 骑行（自行车）
driving 驾车
walking 步行

使用示例

骑行路线查询

AMAP_KEY="你的Key"
FROM="南京"
TO="景德镇"

# 地理编码
FROM_LOC=$(curl -s "https://restapi.amap.com/v3/geocode/geo?address=${FROM}&key=${AMAP_KEY}" | python3 -c "import sys,json; print(json.load(sys.stdin)['geocodes'][0]['location'])")
TO_LOC=$(curl -s "https://restapi.amap.com/v3/geocode/geo?address=${TO}&key=${AMAP_KEY}" | python3 -c "import sys,json; print(json.load(sys.stdin)['geocodes'][0]['location'])")

# 路径规划
curl -s "https://restapi.amap.com/v3/direction/bicycling?origin=${FROM_LOC}&destination=${TO_LOC}&key=${AMAP_KEY}"

输出格式

返回 JSON，包含：

  • 距离（米）
  • 时间（秒）
  • 路线（途经节点）

依赖

  • python3 + requests
  • ffmpeg（如需音频处理）
  • jq（JSON 处理，可选）

注意事项

  • 高德地图 API 有每日调用配额限制（个人开发者 sufficient）
  • 骑行路线数据可能不包含详细海拔信息
  • 部分偏远地区路径数据可能不完整