Amap Navigation

生活服务需配置 API Key

基于高德地图的出行导航，含路线规划、实时路况、公交/打车估价及周边POI搜索。

旅行规划本地生活

240

下载量

安装量

收藏量

★ 4.9

综合评分ⓘ

概述

更多信息

版本: v1.0.0

作者: 玉斧 ( wangyuqin2@xiaohongshu.com)

类别: 出行导航

区域: 中国

概述#

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

核心能力#

1. 多种出行方式对比#

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

2. 路线规划#

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

3. POI搜索#

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

4. 打车估价#

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

触发场景#

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

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

使用方法#

命令行#

路线规划

bash

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

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

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

POI搜索

bash

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

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

打车估价

bash

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

JavaScript API#

javascript

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']
});

参数说明#

参数必填默认值说明--from✅-出发地（地址或经纬度）--to✅-目的地（地址或经纬度）--mode❌driving出行方式：driving/transit/walking/bicycling--strategy❌fastest路线偏好：fastest/shortest/no-highway--alternatives❌1方案数量（1-3）--avoid❌-避开拥堵/高速/收费站

poi_search.js#

参数必填默认值说明--keyword✅-搜索关键词--location✅-搜索中心点--radius❌1000搜索半径（米）--type❌-POI类型（餐饮/酒店/加油站）--sort❌distance排序方式：distance/rating--limit❌10结果数量

taxi_estimate.js#

参数必填默认值说明--from✅-出发地--to✅-目的地--platforms❌gaode平台：gaode/didi/kuaiche/zhuanche--carpool❌false是否拼车

输出格式#

路线规划#

json

{
  "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搜索#

json

{
  "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/人"
    }
  ]
}

打车估价#

json

{
  "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 文件中配置：

bash

# 高德地图 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#

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

免费额度：

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

错误处理#

javascript

// 地址解析失败
{
  "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：智能通勤助手#

bash

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

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

场景2：附近美食推荐#

bash

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

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

场景3：打车价格对比#

bash

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

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