Skip to content

商用车 SDK 导航项目集成说明书

1. 文档说明

本文档适用于需要在车机导航系统中集成以下商用车导航能力：

  • 商用车路线规划
  • 商用车导航中动态重算（DRG）
  • 商用车道路限制与风险提醒
  • 商用车适配限速
  • 商用车电车路线规划与充电站规划
  • 商用车地图匹配与导航过程中的限制识别

2. 车辆画像要求

2.1 基础车辆属性

在发起路线规划或开始导航前，将向 SDK 提供尽可能完整的商用车车辆画像。车辆画像至少将覆盖以下信息：

属性 说明 用途
车辆类型 如卡车、牵引车、半挂车、冷藏半挂车等 路线限制、限速、提醒
车辆长度 车辆总长度 物理限制、急转弯、U 型转弯
车辆宽度 车辆总宽度 物理限制
车辆高度 车辆总高度 物理限制
GVM / GVW 车辆总质量或最大总重量 重量限制
实际重量 当前实际载重后的车辆重量 重量限制
危险品类型 是否运输危险品及危险品类型 危险品道路、隧道限制
隧道限制代码 B / C / D / E / 空值 隧道通行限制
车辆最大速度 如项目侧提供 ETA/ETT、限速相关计算

2.2 重卡属性

属性 说明 用途
轴数量 车辆轴总数 路线限制、提醒
轴距 轴之间距离 重量限制、道路法规
轴组类型 single、tandem、triple、quad、quint 轴组限制
轴组最大载重 每个轴组的最大允许载重 重量限制
每轴车轮类型 single、dual、triple、quad、quint 车轮相关限制
挂车数量 当前挂车数量 挂车限制
挂车类型 项目或数据定义的挂车类型 RDF 挂车限制
挂车长度 挂车长度 物理限制
挂车 GVM 挂车总质量 重量限制
挂车轴数量 挂车轴数 挂车相关限制
挂车轴组类型 挂车轴组配置 挂车相关限制
挂车每轴载重 挂车单轴载重 重量限制
挂车每轴车轮类型 挂车轮组配置 车轮相关限制

2.3 电车 商用车属性

属性 说明
车辆型号 用于 电车 能耗、充电能力等计算
充电接口类型 用于匹配可用充电站
当前电量 必填，SDK 用于判断是否可到达目的地或下一充电站
目标到达电量阈值 用户或 用户 设置的目的地最低期望电量
偏好充电电量区间 用于选择自动规划充电站的位置
停止充电目标电量 用于计算充电时长

3. 路线规划

3.1 路线规划输入

商用车路线规划请求将包含：

  • 起点、终点和途经点。
  • 完整车辆画像。
  • 路线偏好，例如是否允许收费路、是否避开特定道路类型等通用导航偏好。
  • 商用车相关策略配置，例如是否启用 电车 规划、是否启用 商用车 提醒、是否使用在线交通信息等。

SDK 在计算路线时，将综合地图数据、交通信息、车辆画像、商用车法规、时间限制、限速和 电车 约束，返回适合商用车的路线结果。

3.2 法规限制

SDK 将避免进入车辆画像不满足法规要求的区域或道路，包括：

  • 特定行政区域内的商用车禁行限制。
  • 特定车辆类型（如 N1、N2 等）适用的卡车限制。
  • 城市或乡村道路范围内适用的商用车限制。
  • 特定道路类型上的商用车限制。

如果路线必须经过限制区域，或目的地位于限制区域内，SDK 将返回路线，同时返回具体的限制信息

3.3 物理限制

SDK 将基于车辆画像避开不满足通行条件的物理限制道路，包括：

  • 最大高度限制。
  • 最大宽度限制。
  • 最大长度限制。
  • 最大重量限制。
  • 最大轴重限制。
  • 最大轴组载重限制。
  • 车辆或挂车类型限制。
  • 装卸货相关限制。

如果路线无法避开物理限制，SDK 将返回限制原因。用户可根据项目策略决定是否展示该路线，但不得将其展示为普通无风险路线。

3.4 危险品与隧道限制

SDK 将根据危险品类型和隧道限制代码判断车辆是否可通过隧道或危险品限制道路。

隧道限制代码含义如下：

代码 说明
B 禁止通过标识为 B、C、D、E 的隧道
C 禁止通过标识为 C、D、E 的隧道
D 禁止通过标识为 D、E 的隧道
E 仅禁止通过标识为 E 的隧道
空值 无隧道限制代码或不适用

如车辆运输危险品，SDK 将避免不允许对将危险品类型通行的道路、区域和隧道。

3.5 时间限制

SDK 将支持基于固定日期、星期、时段等条件的时间限制判断。

时间限制处理规则：

  • 如果时间限制在预计通行时段内生效，SDK 将避开该限制区域。
  • 如果路线必须通过时间限制区域，SDK 将返回路线并提供时间限制信息。
  • 如果时间限制在预计通行时段内不生效，该路线可视为无限制路线。
  • 判断时间限制是否生效时，将使用 20 分钟作为检查窗口。
  • 当长度、高度、宽度等物理限制与时间限制组合生效时，该限制将作为物理限制处理，并返回组合限制原因。
  • SDK目前暂不支持返回具体时间字段信息。

3.6 急转弯与 U 型转弯

SDK 将根据车辆长度、物理尺寸和道路几何信息，默认避开商用车无法通过的急转弯和 U 型转弯。

集成规则：

  • SDK 默认避开不可通行的急转弯，无需用户额外提供开关。
  • SDK 默认避开不可通行的 U 型转弯，无需用户额外提供开关。
  • 如果路线无法完全避开急转弯或 U 型转弯，SDK 将返回无法回避类型的提示信息。

4. 限制分类与返回规则

4.1 强限制

强限制表示路线不将作为普通可通行路线提供给用户。SDK 将至少将以下限制作为强限制处理：

  • 高度限制。
  • 长度限制。
  • 宽度限制。
  • 车辆类型限制。
  • 与高度、长度、宽度等物理限制组合生效的时间限制。

当出现强限制时，SDK 将返回限制原因、限制值和受影响位置。

4.2 软限制

除明确强限制以外，其他限制通常作为软限制处理。软限制路线可以返回给 用户，但必须带有限制信息或警告。

软限制包括但不限于：

  • 时间限制。
  • 危险品限制。
  • 重量限制。
  • 最大轴重限制。
  • 轴组限制。
  • 轴组最大载重限制。
  • 每轴车轮限制。
  • 轴数量限制。
  • 挂车类型限制。
  • 隧道限制。

4.3 多限制组合

当同一路段同时存在两个或更多限制时，SDK 将将这些限制以组合形式返回。

返回信息将包含：

  • 每个限制的类型。
  • 每个限制的实际限制值。
  • 限制适用条件，例如时段、车辆类型、危险品类型等。

5 路线规划输出

SDK 路线规划结果将包含：

  • 路线列表。
  • 每条路线的 ETA。
  • 每条路线的 ETT。
  • 每条路线的距离。
  • 每条路线的商用车限制信息。
  • 每条路线的强/软限制分类。
  • 每条路线的可通行状态。
  • 每条路线的限速信息。
  • 如适用，电车 充电站 stopover 和充电计划。

如果路线无法满足车辆画像或策略要求，SDK 将返回明确错误或警告。

6. 限速策略

6.1 限速来源

SDK使用地图供将商提供的适用于当前车辆的限速结果。限速计算将考虑：

  • 道路类型和道路法规。
  • 普通交通法规。
  • 商用车车辆类型。
  • 车辆尺寸、重量、轴组、挂车等车辆属性。
  • 时间相关限速。
  • 临时限速和永久限速。

6.2 限速使用场景

最终限速将被用于：

  • ETA / ETT 计算。
  • 路线计算。
  • 地图匹配。
  • 超速提醒。
  • 导航过程中的限速展示。

7. 地图匹配

SDK 在导航地图匹配过程中，将使用地图供将商提供的、适用于当前车辆画像的限速和限制结果。

地图匹配策略：

  • 当存在多个候选匹配道路时，SDK 将优先选择可避开限制道路的候选路线。
  • 如果候选道路存在商用车限制，SDK 将结合车辆画像判断该限制是否适用于当前车辆。

8. 导航中动态重算（DRG）

8.1 触发场景

导航过程中，SDK将在以下场景触发动态重算：

  • 车辆画像发生变化。
  • 车辆偏航。
  • 地图内容切换。
  • 前方时间限制即将生效。
  • 前方道路阻断。
  • 存在可节省时间的新路线。
  • 电车车辆无法到达下一充电站或目的地。
  • 电车车辆预计到达目的地电量低于用户设置阈值。
  • 电车车辆在非规划充电站充电或过充后，原计划不再适用。

8.2 车辆画像变更

当商用车车辆画像发生变化时，SDK 必须重新计算路线。

处理规则：

  • 如果新路线没有限制，SDK 将返回新路线。
  • 如果新路线存在软限制，SDK 将返回新路线和限制信息。
  • 如果新路线存在强限制，SDK 不将将其作为普通可通行路线返回，将提供 route request failure、no valid route 或 black route 信息。

8.3 时间限制、阻断和节省时间

当前方时间限制即将生效、道路阻断或存在节省时间的新路线时，SDK 将提供新路线建议。

处理规则：

  • 如果新路线没有限制，SDK将作为建议路线提供给用户选择。
  • 如果新路线存在软限制，SDK将返回建议路线并带限制警告。
  • 如果新路线存在强限制，SDK不将其作为普通建议路线提供。
  • 用户接受某条建议路线后，SDK不会重复提供同一条建议。

8.4 偏航和地图内容切换

当车辆偏航或地图内容切换导致当前路线不可继续使用时，SDK 必须重新计算路线。

处理规则：

  • 如果新路线没有限制，SDK 将强制提供新路线。
  • 如果新路线存在软限制，SDK 将强制提供新路线并带限制警告。
  • 如果新路线存在强限制，SDK 将返回 no valid route、route request failure 或 black route 信息，供 用户 HMI 决定是否展示。

9. 商用车沿途信息

9.1 沿途信息提醒范围

SDK 将在 MPP 区域内识别并提供商用车相关提醒。提醒包括但不限于：

  • 急转弯。
  • 高度限制。
  • 窄路。
  • 陡坡下行。
  • 陡坡上行。
  • 路面凸起。
  • 车辆侧倾风险。
  • 重量限制。
  • 宽度限制。
  • 长度限制。
  • 时间限制。
  • 危险品限制。
  • 隧道限制。
  • 车辆类型限制。
  • 轴组限制。
  • 最大轴重或轴组载重限制。
  • 每轴车轮限制。
  • 挂车限制。
  • 轴数量限制。
  • 超速提醒。

9.2 提醒开关

每类提醒音频都将提供独立开关，默认关闭。

例外：多限制组合提醒不设置单独开关。当两个或更多限制提醒同时被触发时，SDK 可触发多限制组合提醒。

9.3 音频提醒文案模式

SDK 将提供本地化提醒文案，用户可根据项目 TTS 和语言包接入。

普通提醒模式：

  • {提醒类型} ahead
  • 中文建议表达：前方{提醒类型}
  • 举例：前方陡坡

不可通行提醒模式：

  • {限制类型} ahead, cannot pass through
  • 中文建议表达：前方{限制类型}，无法通行
  • 举例：前方长度限制，无法通行

危险品限制示例：

  • hazardous material prohibited ahead
  • 中文建议表达：前方禁止运输该类危险品车辆通行

多限制组合提醒：

  • warning, restrictions ahead, cannot pass through
  • 中文建议表达：警告，前方存在多项限制，无法通行

9.4 超速提醒

SDK 将基于适用于当前车辆画像的商用车限速判断是否超速。

当车辆速度超过当前适用限速时，SDK 将触发超速提醒：

  • 英文示例：you are overspeed
  • 中文建议表达：您已超速

超速提醒使用的限速将来自地图供应商输出的最终商用车限速结果。

9.5 多语言支持

商用车提醒音频支持SDK语音支持的语言范围，请参考TASDK地区国家语言支持能力

10. 电车商用车路线规划

10.1 输入要求

电车商用车路线规划将包含：

  • 车辆静态信息：车辆型号、充电接口类型。
  • 车辆动态信息：当前电量必填，当前重量可选。
  • 商用车车辆画像。
  • 起点、终点和途经点。
  • 商用车路线对象或商用车路线规划结果。
  • 用户设置的电车偏好，例如目标到达电量、偏好充电电量区间等。

10.2 自动充电站规划

SDK在电车商用车路线规划中最多自动规划一个充电站。

处理规则：

  • 如果当前电量足以到达目的地，SDK 将返回不包含自动充电站的商用车路线。
  • 如果当前电量不足以到达目的地，SDK 将返回包含一个充电站的商用车路线。
  • 充电站将尽量位于偏好充电电量区间附近。
  • SDK 将从候选充电站中选择综合排序最优的站点。
  • 充电站不将位于当前车辆受限区域内。
  • 如果带 stopover 的路线存在不允许通过的限制，SDK 不将将该 stopover 加入路线。

充电站候选路线的限制策略将与原始路线限制等级保持一致：

  • 原始路线无限制时，SDK 将优先查找无限制的充电站路线。
  • 原始路线为软限制路线时，SDK 可查找带软限制的充电站路线。
  • 原始路线为强限制路线时，SDK 可按强限制策略处理候选路线，但不得将其作为普通可通行路线展示。

10.3 电车 路线输出

电车 商用车 路线结果将包含：

  • Telenav 商用车 Route 或项目定义的 商用车 route object。
  • 如适用，充电站 stopover。
  • 到充电站、途经点和目的地的预计到达电量。
  • 行驶 ETT。
  • 如规划了充电站，返回 stopover 充电时长。
  • 如一个 stopover 足够到达目的地，返回充至偏好停止充电值所需的充电时长。

如果途经点或目的地不可达，SDK 将返回 no match。

如果所有候选充电站路线都存在不可接受限制，SDK 将返回不带 stopover 的路线或明确的 plan failed / no match 信息，具体以项目接口定义为准。

10.4 电车 导航中动态更新

导航过程中，SDK 将在以下场景更新 电车 充电计划：

  • Range monitor 检测到车辆无法到达下一规划充电站。
  • 没有规划充电站时，车辆无法到达目的地。
  • 预计到达目的地电量低于用户设置阈值。
  • 车辆在非规划充电站充电。
  • 车辆过充或当前充电行为导致原 电车 计划不再适用。

处理规则：

  • SDK 将重新计算 电车 路线并尝试规划新的充电站。
  • 如果新路线不包含充电站且无法满足可达性要求，SDK 将丢弃该路线并返回 plan failed。
  • 如果新路线存在不可接受的限制，SDK 将返回 no route available 或 plan failed。
  • 用户 HMI 将明确提示用户当前充电计划已更新或更新失败。

11. 用户集成建议

SDK 返回的商用车信息将被用户明确展示给驾驶员，避免驾驶员误以为限制路线可正常通行。

推荐展示规则：

  • 无限制路线按普通路线展示。
  • 软限制路线可展示为可选路线，但需展示限制标签和原因。
  • 强限制路线将以不可通行、高风险方式展示，不将与普通路线混淆。
  • 多限制场景将合并展示限制组，并允许用户查看具体限制明细。
  • 限制值将展示真实数值或用户可理解文本。
  • 电车充电计划将展示预计到站电量、预计充电时长和预计到达目的地电量。

对应技术模块