什么是 高德地图导航与出行助手？

高德地图导航技能是为 AI 代理设计的尖端集成方案，利用高德地图（Gaode Maps）Web 服务 API 提供本地化出行情报。作为 Openclaw Skills 库的重要补充，它使代理能够执行复杂的路径规划、监测实时路况并对比不同供应商的叫车成本。该技能针对中国市场进行了专门优化，确保在地址解析和兴趣点（POI）搜索方面具有极高准确性。

通过集成此技能，开发者可以为用户提供无缝的城市环境导航方式。它弥合了原始地图数据与可执行出行建议之间的差距，支持包括驾车、公交、步行和骑行在内的多种交通模式。实时拥堵提醒和收费站信息的加入，使其成为构建可靠通勤助手的必备工具。

下载入口:https://github.com/openclaw/skills/tree/main/skills/wangyuqin378-cpu/amap-navigation

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

高德地图导航与出行助手 应用场景

• 规划两地间避开拥堵的最快驾车路线。
• 对比滴滴和高德平台的打车费用，实现高性价比出行。
• 搜索周边设施，如高分餐厅、加油站或停车场。
• 为需要减少步行或换乘的用户生成多模式交通指南。

1. AI 代理识别出行相关的意图，并提取起点、终点和偏好参数。
2. 技能使用环境配置中受保护的 API Key 向高德 Web 服务 API 发起请求。
3. 后端逻辑处理坐标转换，并获取实时路况或价格数据。
4. 系统根据最快时间或最短距离等用户策略评估多种路线方案。
5. 生成结构化的 JSON 响应，为 AI 代理提供清晰的建议和分步说明。

高德地图导航与出行助手 配置指南

要在 Openclaw Skills 生态系统中使用此技能，您必须先配置环境变量：

# 1. 在 lbs.amap.com 注册并创建一个“Web 服务”应用以获取您的 API Key。
# 2. 将凭据添加到项目根目录的 .env 文件中：
AMAP_API_KEY=your_api_key_here

# 3. 您现在可以通过 CLI 测试导航：
node scripts/navigation.js --from "起点地址" --to "终点地址" --mode driving

高德地图导航与出行助手 数据架构与分类体系

该技能根据请求类型将其输出组织成特定模式。以下是 Openclaw Skills 集成的元数据分类：

amap-navigation - 高德地图导航与出行助手

版本: v1.0.0
作者: 玉斧 (wangyuqin2@xiaohongshu.com)
类别: 出行导航
区域: 中国

概述

高德地图导航与出行助手。支持路线规划、实时路况、打车估价、POI搜索、距离计算。

核心能力

1. 多种出行方式对比

• ?? 驾车导航（实时路况、拥堵预警）
• ?? 公交路线（最少换乘、最少步行、最快到达）
• ?? 步行导航
• ?? 骑行路线
• ?? 打车估价（滴滴/高德/快车/专车）

2. 路线规划

• 智能推荐最优路线
• 多方案对比（时间最短、距离最短、不走高速）
• 实时路况信息
• 红绿灯数量
• 收费站信息

3. POI搜索

• 附近美食、酒店、加油站、停车场
• 关键词搜索
• 按距离/评分排序
• 营业时间、价格区间

4. 打车估价

• 支持平台：滴滴、高德、快车、专车
• 预估价格、预计时间
• 拼车/独享对比
• 优惠券提示

触发场景

当用户询问以下内容时激活：

• "怎么去XX"
• "从A到B路线"
• "导航到XX"
• "打车到XX多少钱"
• "附近有什么XX"
• "最快路线"
• "实时路况"

使用方法

命令行

路线规划

# 基础用法
node scripts/navigation.js r
  --from "浙江省杭州市西湖区" r
  --to "浙江省杭州市滨江区阿里巴巴西溪园区" r
  --mode driving

# 公交路线
node scripts/navigation.js r
  --from "北京站" r
  --to "首都机场" r
  --mode transit r
  --prefer "least-time"

# 多方案对比
node scripts/navigation.js r
  --from "上海虹桥火车站" r
  --to "上海浦东机场" r
  --mode driving r
  --alternatives 3

POI搜索

# 搜索附近餐厅
node scripts/poi_search.js r
  --keyword "川菜" r
  --location "北京市朝阳区三里屯" r
  --radius 1000

# 搜索加油站
node scripts/poi_search.js r
  --type "加油站" r
  --location "上海市浦东新区陆家嘴" r
  --sort distance

打车估价

# 估算打车费用
node scripts/taxi_estimate.js r
  --from "杭州东站" r
  --to "西湖风景区" r
  --platforms "didi,gaode"

JavaScript API

const AMapNavigation = require('./scripts/navigation.js');

// 路线规划
const route = await AMapNavigation.planRoute({
  origin: '116.481028,39.989643',  // 经纬度或地址
  destination: '116.434446,39.90816',
  mode: 'driving',  // driving, transit, walking, bicycling
  strategy: 'fastest'  // fastest, shortest, no-highway
});

// POI搜索
const pois = await AMapNavigation.searchPOI({
  keyword: '星巴克',
  location: '上海市静安区',
  radius: 2000,
  limit: 10
});

// 打车估价
const estimate = await AMapNavigation.estimateTaxi({
  from: '北京南站',
  to: '天安门广场',
  platforms: ['didi', 'gaode']
});

参数说明

navigation.js

poi_search.js

taxi_estimate.js

输出格式

路线规划

{
  "status": "success",
  "mode": "driving",
  "routes": [
    {
      "name": "方案1（推荐）",
      "distance": "15.2 km",
      "duration": "28分钟",
      "traffic": "畅通",
      "toll": "0元",
      "strategy": "时间最短",
      "steps": [
        "从起点出发，沿XX路向北行驶500米",
        "右转进入XX路，行驶2.3公里"
      ]
    }
  ],
  "recommendation": "建议选择方案1，预计28分钟到达，当前路况畅通"
}

POI搜索

{
  "status": "success",
  "total": 15,
  "pois": [
    {
      "name": "星巴克（静安店）",
      "address": "上海市静安区XX路123号",
      "distance": "350米",
      "rating": 4.5,
      "phone": "021-12345678",
      "hours": "08:00-22:00",
      "price": "￥30-50/人"
    }
  ]
}

打车估价

{
  "status": "success",
  "estimates": [
    {
      "platform": "高德打车",
      "service": "快车",
      "price": "￥25-30",
      "duration": "18分钟",
      "distance": "8.5 km"
    },
    {
      "platform": "滴滴出行",
      "service": "快车",
      "price": "￥28-33",
      "duration": "20分钟",
      "distance": "8.5 km"
    }
  ],
  "recommendation": "推荐使用高德打车快车，价格最优"
}

配置要求

环境变量

在工作区根目录 .env 文件中配置：

# 高德地图 API Key（必需）
AMAP_API_KEY=your_api_key_here

# 可选配置
AMAP_API_SECRET=your_secret_here  # 部分API需要
AMAP_BASE_URL=https://restapi.amap.com  # 默认值

获取 API Key

1. 访问 高德开放平台
2. 注册/登录账号
3. 进入"应用管理" → "我的应用"
4. 创建应用，选择"Web服务"
5. 复制 API Key 到 .env 文件

免费额度：

• 每日调用量：30万次
• QPS限制：3000次/秒
• 个人开发者可申请更高额度

错误处理

// 地址解析失败
{
  "status": "error",
  "code": "GEOCODE_FAILED",
  "message": "无法解析地址：XX路XX号"
}

// API Key 无效
{
  "status": "error",
  "code": "INVALID_API_KEY",
  "message": "请在 .env 文件中配置有效的 AMAP_API_KEY"
}

// 无可用路线
{
  "status": "error",
  "code": "NO_ROUTE",
  "message": "未找到从A到B的可行路线"
}

实际应用场景

场景1：智能通勤助手

# 用户："从家到公司最快路线"
node scripts/navigation.js r
  --from "北京市朝阳区XX小区" r
  --to "北京市海淀区中关村软件园" r
  --mode driving r
  --strategy fastest r
  --alternatives 3

# 输出：
# - 方案1：三环-四环路线，28分钟，轻微拥堵
# - 方案2：走五环绕行，35分钟，畅通
# - 建议：选择方案1，虽有拥堵但仍最快

场景2：附近美食推荐

# 用户："附近有什么好吃的川菜馆"
node scripts/poi_search.js r
  --keyword "川菜" r
  --location "当前位置" r
  --radius 2000 r
  --sort rating r
  --limit 5

# 输出：
# 1. 巴蜀风味（4.8星，500米）
# 2. 蜀香阁（4.6星，800米）
# 3. 川渝人家（4.5星，1.2公里）

场景3：打车价格对比

# 用户："从机场到酒店打车多少钱"
node scripts/taxi_estimate.js r
  --from "首都机场T3航站楼" r
  --to "北京朝阳区XX酒店" r
  --platforms "didi,gaode"

# 输出：
# 高德打车：￥85-95，50分钟
# 滴滴出行：￥88-98，52分钟
# 建议：高德打车略便宜，预计50分钟到达

技术实现

核心依赖

• Node.js 内置 https 模块（API调用）
• 高德地图 Web服务 API v7.0

API端点

• 路线规划：/v5/direction/{mode}
• 地理编码：/v3/geocode/geo
• POI搜索：/v5/place/text
• 距离计算：/v5/direction/distance

注意事项

1. API Key 安全

   • 不要在代码中硬编码 API Key
   • 使用环境变量或配置文件
   • 定期更换 Key

2. 调用频率

   • 注意 QPS 限制
   • 使用缓存减少重复调用
   • 批量请求时添加延迟

3. 坐标系统

   • 高德使用 GCJ-02（火星坐标系）
   • GPS坐标需转换

4. 隐私保护

   • 不记录用户位置历史
   • 敏感地址脱敏处理

输出物

路线方案 + 时间距离 + 实时路况 + 出行建议

下一步

• 集成实时路况拥堵指数
• 支持途经点规划
• 添加停车场推荐
• 地铁路线优化

许可证

MIT License

ClawHub 生态贡献
填补中国本土化出行服务空白