# Route Planning

> 基于百度地图提供驾车、步行、骑行、公交路线规划及批量算路能力，返回路线距离、时间、路段详情等，适用于出行规划、路线对比、物流配送场景。

- Skill: `qq5855144/route-planning` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add qq5855144/route-planning`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qq5855144/route-planning/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: qq5855144 (https://skillmd.com/u/qq5855144)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qq5855144/route-planning

---


## 能力概述

基于百度地图 Direction API v2 和 RouteMatrix API v2，提供以下七个接口：

| 接口名称 | Endpoint | 方法 | 说明 |
|---------|---------|------|------|
| 驾车路线规划 | `GET https://app-bo4w33bsdqm9-api-GaDwZKpJxXOY-gateway.appmiaoda.com/direction/v2/driving` | GET | 单次驾车路线，支持多种策略 |
| 骑行路线规划 | `GET https://app-bo4w33bsdqm9-api-W9z3MpAdKeNL-gateway.appmiaoda.com/direction/v2/riding` | GET | 单次骑行路线 |
| 步行路线规划 | `GET https://app-bo4w33bsdqm9-api-wLNdomNRn42a-gateway.appmiaoda.com/direction/v2/walking` | GET | 单次步行路线 |
| 公交路线规划 | `GET https://app-bo4w33bsdqm9-api-m9xKXQkOKZXa-gateway.appmiaoda.com/direction/v2/transit` | GET | 公共交通路线，含换乘方案和票价 |
| 驾车批量算路 | `GET https://app-bo4w33bsdqm9-api-6LeBrqqMqKQY-gateway.appmiaoda.com/routematrix/v2/driving` | GET | 多起点多终点笛卡尔积算路 |
| 骑行批量算路 | `GET https://app-bo4w33bsdqm9-api-Aa2Pq88pDANL-gateway.appmiaoda.com/routematrix/v2/riding` | GET | 批量骑行距离耗时计算 |
| 步行批量算路 | `GET https://app-bo4w33bsdqm9-api-qYGW2zz1MklY-gateway.appmiaoda.com/routematrix/v2/walking` | GET | 批量步行距离耗时计算 |

**认证方式**：`platform_managed`，密钥由平台注入，通过 `INTEGRATIONS_API_KEY` 环境变量读取，
Header 统一使用 `X-Gateway-Authorization: Bearer ${apiKey}`。

**支持平台**：Web、MiniProgram（响应均为 JSON，两平台实现相同）。

**响应格式**：所有接口返回 JSON，`status=0` 表示成功，`result.routes[]` 包含路线方案。

## 生成期用法（Agent 直接调用）

所有接口均为 GET 请求，参数通过 URL Query String 传递，认证通过 `X-Gateway-Authorization` header。

```typescript
// 驾车路线规划示例
const apiKey = process.env.INTEGRATIONS_API_KEY;
const origin = "40.056878,116.30815";   // 起点纬度,经度
const destination = "39.767892,116.527308"; // 终点纬度,经度

const url = new URL("https://app-bo4w33bsdqm9-api-GaDwZKpJxXOY-gateway.appmiaoda.com/direction/v2/driving");
url.searchParams.set("origin", origin);
url.searchParams.set("destination", destination);
url.searchParams.set("output", "json");

const response = await fetch(url.toString(), {
  headers: { "X-Gateway-Authorization": `Bearer ${apiKey}` },
});
const data = await response.json();

if (data.status === 0) {
  const route = data.result.routes[0];
  console.log(`距离：${route.distance} 米，预计时间：${route.duration} 秒`);
} else {
  console.error(`请求失败，status=${data.status}，message=${data.message}`);
}
```

完整参数说明、生成期代码示例详见：

- [references/direction-api.md](references/direction-api.md) — 驾车 / 骑行 / 步行 / 公交路线规划接口
- [references/routematrix-api.md](references/routematrix-api.md) — 驾车 / 骑行 / 步行批量算路接口

## 生成后用法（应用内通过 Edge Function 调用）

在应用中，前端调用 Supabase Edge Function，Edge Function 在服务端注入 `INTEGRATIONS_API_KEY`
并转发请求到百度地图 API，避免密钥暴露到客户端。

Web 和 MiniProgram 均可使用 `supabase.functions.invoke` 调用，响应为标准 JSON。

完整 Edge Function 代码、前端调用代码及各接口注意事项详见：

- [references/direction-api.md](references/direction-api.md) — 驾车 / 骑行 / 步行 / 公交路线规划
- [references/routematrix-api.md](references/routematrix-api.md) — 驾车 / 骑行 / 步行批量算路