概述

导航（Navigation）

导航模块负责在选定路线后输出逐向引导、行程进度与实时驾驶相关信息。其能力覆盖真实导航与模拟导航、导航状态回调、换路与更优路检测、备选路管理、沿途交通展示、路线修改，以及 EV/卡车等车型特化导航。

能力地图

• 真实导航与模拟导航：导航会话启动、停止与模拟行驶。
• 导航状态信息：导航主要状态通知（约 1 Hz）。
• 导航指令列表： 导航指令列表（Turn-By-Turn）。
• 路口放大图：路口放大图数据与显示控制。
• 到达和离开：停靠点到达/离开事件通知与配置。
• 限时通行：限时限制识别、规避策略与提示联动。
• 沿途交通：沿路路况及其配置。
• 更优的路： 更优路线检测与用户确认。
• 换路通知：导航中换路状态通知（自动/主动换路）。
• 备选路：备选路线计算、展示与切换。
• 路线修改：导航中主动更新路线请求（终点、途经点、避让）。
• EV导航：低电量预警、可达性检查与 EV 路线更新。
• 商用车导航：商用车、货车限制与合规的动态导航。

使用前提

• 已完成 NavigationService 初始化并可成功算路。
• 地图显示能力已接入（用于绘制主路线/备选路及沿途信息）。
• 已注册业务所需监听器（导航状态、播报、沿途信息等）。

典型流程

路线规划成功
   ↓
启动导航会话（真实/模拟）
   ↓
接收状态与引导事件（进度、机动点、沿途交通、播报）
   ↓
按需处理换路通知 / 更优路 / 备选路切换 / 路线修改
   ↓
到达目的地或主动结束导航

重要概念

沿路、偏航与离路

导航与地图匹配文档中常使用以下三种状态。请勿将 偏航（off-route / deviation） 与 离路（off-road） 混为一谈：

概念	英文常用说法	地图匹配	与导航路线关系	典型含义
沿路	on-route	已匹配到道路	沿当前导航路线行驶	正常导航
偏航	off-route、deviation	已匹配到道路	不在当前导航路线上（行驶在其它道路上）	走错路，可能触发 换路通知
离路	off-road	未匹配到任何道路	无法定义「是否在路线上」	停车场、空地、隧道弱信号等

Branch Name 与 Towards Name（路牌分支名与方向名）

在分岔路口、高速出口等存在路牌（signpost）的机动点，引导信息可能同时包含两类名称。ManeuverInfo 中分别对应 signpostBranchNames、signpostTowardsNames（均为 List<Name>?）。

概念	SDK 字段	含义	路牌上的典型表现
Branch Name（分支名 / onto）	signpostBranchNames	当前路口应驶入的那条分支道路的名称，即转弯后立即进入的道路	岔路口指向某条路的名称，或匝道末端指向的具体路名
Towards Name（方向名）	signpostTowardsNames	该分支所通往的远端目的地或方向的指示，不一定是即将驶入的即时路名	「Towards Downtown」「往机场方向」等

示例： 出口路牌显示「I-405 South」为 Branch（应驶入的分支），「Towards Long Beach」为 Towards（该分支通向的方向）。