Route Planning

能力概述

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

认证方式：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。

// 驾车路线规划示例
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/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/routematrix-api.md — 驾车 / 骑行 / 步行批量算路