高级功能 最后更新时间: 2026年05月29日

导航组件的配置类

AmapNaviParams中提供了很多配置方法，支持在启动同时传入，满足自定义需求。

启动相关配置

如果已经在外部通过AMapNavi计算过一条路线，可以选择启动组件不进行重新算路，使用现有路线进行导航。 

/**
 * 启动组件进行直接导航时，设置是否进行算路 (只有在直接跳转导航页的情况下才生效)
 *
 * @param needCalculateRouteWhenPresent true : 算路，false : 启动组件以后不会算路直接开启导航。默认为true。
 * @since 5.6.0
 */
public setNeedCalculateRouteWhenPresent(needCalculateRouteWhenPresent: boolean) 

可以选择启动组件的导航界面，还是路线规划界面。

// 组件参数配置
const params = AmapNaviParams.buildForPageType(start, null, end, AmapNaviType.Driver, AMapPageType.NAVI);

设置退出导航组件的时候是否停止并且销毁导航。

/**
 * 设置退出导航组件是否销毁导航实例
 *
 * @param destroy true-退出导航页时停止导航，退出组件时销毁导航
 *                false-退出组件不会销毁导航；当使用组件直接导航时，退出导航页也不会停止导航
 * @since 5.6.0
 */
public setNeedDestroyDriveManagerInstanceWhenNaviExit(destroy: boolean): AmapNaviParams 

其他重要配置参数。

/**
 * 设置车辆信息，进行尾号限行与货车导航
 *
 * @param carInfo {@link AMapCarInfo}<br>
 * @since 6.0.0
 */
public setCarInfo(carInfo: AMapCarInfo): AmapNaviParams 

/**
 * 设置是否使用内部语音播报
 *
 * @param isUseInnerVoice 是否使用内部语音播报
 *                        注意：6.1.0版本开始，默认值改为true
 * @since 6.0.0
 */
public setUseInnerVoice(isUseInnerVoice: boolean): AmapNaviParams

/**
 * 设置组件规划路线的策略，默认为{@link com.amap.api.navi.enums.PathPlanningStrategy#DRIVING_MULTIPLE_ROUTES_DEFAULT}，速度优先+躲避拥堵+距离较短
 *
 * @param routeStrategy {@link com.amap.api.navi.enums.PathPlanningStrategy}
 */
public setRouteStrategy(routeStrategy: PathPlanningStrategy): AmapNaviParams

/**
 * 设置播报模式
 *
 * @param context
 * @param mode  1-简洁播报 2-详细播报 3-静音模式
 * @since 7.1.0
 */
public setBroadcastMode(mode: AMapNaviBroadcastMode): AmapNaviParams

/**
 * 设置导航视角
 *
 * @param context
 * @param mode 0-车头朝上 1-正北朝上
 * @since 7.1.0
 */
public setCarDirectionMode(mode: AMapNaviViewTrackingMode): AmapNaviParams

/**
 * 设置比例尺智能缩放是否开启
 *
 * @param context
 * @param enable
 * @since 7.1.0
 */
public setScaleAutoChangeEnable(enable: boolean): AmapNaviParams