百度地图开放平台
更新时间: 2026/07/22 20:35
多路线导航
下载开发文档
概述

多路线导航,即实时导航中有多条路线供用户选择,用户可以根据提供的时间、距离、费用等信息,自行点击路线进行引导路线的变更。

1. 核心接口
1.1 路线规划接口 BNIRoutePlanInterface
export interface BNIRoutePlanInterface {
/**
* 设置是否启用多路线
* @param isEnabled - true 启用多路线,false 禁用多路线
*/
setIsMultiRouteEnabled(isEnabled: boolean): void;
/**
* 获取是否启用多路线
* @returns 多路线是否启用
*/
readonly isMultiRouteEnabled: boolean;
}
2. 功能详解
2.1 启用/禁用多路线
setIsMultiRouteEnabled(isEnabled: boolean): void

路线规划前,设置是否启用多路线自动切换功能
参数说明

  • isEnabled - 是否启用多路线

  • true - 启用多路线,导航中会自动推荐和切换更优路线

  • false - 禁用多路线,导航严格按规划路线行驶

存储机制:配置会持久化存储到本地设备,默认值为 true(启用多路线)。

2.2 获取多路线状态
readonly isMultiRouteEnabled: boolean

获取当前多路线功能的启用状态。
特点

  • 只读属性

  • 返回持久化存储的配置值

  • 如未设置过,默认返回 true

3. 使用示例
3.1 基础用法
// 禁用多路线 - 场景:路线规划前设置,路线规划结果只返回一条路线
sdkService.routePlan.setIsMultiRouteEnabled(false);
// 检查状态
const isEnabled = routePlanAbility.isMultiRouteEnabled;
console.log(`多路线状态:${isEnabled ? '已启用' : '已禁用'}`);
// 启用多路线 - 恢复到默认行为
routePlanAbility.setIsMultiRouteEnabled(true);

上一篇

路线规划

下一篇

导航实时数据
本篇文章对您是否有帮助?