Baidu Traffic Condition

能力概述

基于百度地图交通路况 API，提供分钟级实时道路拥堵数据，支持四种查询维度：

所有接口均返回 JSON，包含整体拥堵评价（evaluation）和各拥堵路段详情（congestion_sections / roads）。

认证模式：platform_managed（密钥由平台注入，前端无需关心）

支持平台：Web、MiniProgram

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

详见各接口的参数说明和代码示例：

• references/traffic-road-api.md — 道路实时路况查询（按道路名称搜索拥堵评价与拥堵路段）
• references/traffic-bound-api.md — 矩形区域实时路况查询（通过左下/右上角坐标定义矩形范围）
• references/traffic-polygon-api.md — 多边形区域实时路况查询（通过多顶点坐标定义不规则区域）
• references/traffic-around-api.md — 周边实时路况查询（以中心点坐标和半径定义圆形范围）

平台密钥通过 process.env["INTEGRATIONS_API_KEY"] 读取，Auth header 统一使用 "X-Gateway-Authorization": \Bearer ${apiKey}``。

快速示例（查询某条道路的实时路况）：

const apiKey = process.env["INTEGRATIONS_API_KEY"]!;

// 查询「长安街」在北京的实时路况
const response = await fetch(
  "https://app-bo4w33bsdqm9-api-rLobR3D3dbg9-gateway.appmiaoda.com/traffic/v1/road" +
    "?road_name=" + encodeURIComponent("长安街") +
    "&city=" + encodeURIComponent("北京"),
  {
    method: "GET",
    headers: { "X-Gateway-Authorization": `Bearer ${apiKey}` },
  }
);
if (!response.ok) throw new Error(`HTTP error: ${response.status}`);
const json = await response.json();
if (json.status !== 0) throw new Error(`API error ${json.status}: ${json.message}`);

// json.evaluation.status: 1=畅通, 2=缓行, 3=拥堵, 4=严重拥堵
console.log("整体路况评价：", json.evaluation.status);
console.log("拥堵路段数：", json.congestion_sections?.length ?? 0);

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

每个接口对应一个独立的 Edge Function，前端通过 supabase.functions.invoke 调用， 平台密钥仅在 Edge Function 服务端注入，不暴露到前端。

Web 和 MiniProgram 均使用标准 supabase.functions.invoke 调用方式，响应均为 JSON， 无二进制流，两个平台实现无差异。完整 Edge Function 和前端代码详见各 references/ 文件。