开发 HarmonyOS NEXT 导航SDK 开发指南 UI界面定制 显示模式与跟随模式

显示模式与跟随模式 最后更新时间: 2026年05月29日

显示模式

导航界面的显示模式分为:

  • 锁车态:地图图面一直跟着定位位置的改变而移动,又由于自车图标也在移动,两者相互抵消,视觉上会感觉自车图标被锁在屏幕的一个固定的点上;
  • 全览态:地图的中心点和缩放层级都调整到合适的值来让整条路线都显示在可见区域内;
  • 普通态:地图图面一直不动,只有自车图标在移动。

          

通过 AMapNaviViewOptions 中接口设置锁车相关配置。

/**
* 设置自动锁车逻辑开关
*
* @param autoLockCar true代表自动锁车,false代表不自动锁车
* @since 2.2.3
*/
public setAutoLockCar(autoLockCar: boolean):  void

/**
* 设置是否自动全览模式,即在算路成功后自动进入全览模式
* @param isAutoDisplay
* @since 2.2.3
*/
public setAutoDisplayOverview(isAutoDisplay: boolean):  void

/**
* 设置锁定地图延迟毫秒数。
*
* @param lockMapDelayed 延迟毫秒。
* @since 2.2.3
*/
public setLockMapDelayed(lockMapDelayed: number):  void 

注意:AMapNaviViewOptions.setAutoDisplayOverview()方法在新版本中不建议使用,可通过IAMapNavi.setShowMode()来动态设置模式。

/**
* 设置导航页面显示模式
*
* @param showMode 1-锁车态 2-全览态 3-普通态
* @since 2.2.3
*/
setShowMode(showMode: number): void

通过 IAMapNaviListener 类监听显示模式变化。

/**
*导航视图展示模式变化回调
*
* @param showMode 展示模式
* @since 2.2.3
*/
onNaviViewShowMode?: (showMode:number) => void

车头朝向

导航界面的车头朝上、正北朝上 

          

通过IAMapNavi类调整车头朝向。

/**
* 设置车头朝向
* @param mode 车头朝向
*  0-CAR_UP_MODE 车头朝上模式
*  1-NORTH_UP_MODE 正北朝上模式
* @since 2.2.3
*/
setNaviMode(mode: number): void

通过IAMapNaviListener监听车头朝向变化。

/**
* 导航视角变化回调
*
* @param naviMode 导航视角,0:车头朝上状态;1:正北朝上模式。
* @since 2.2.3
*/
onNaviMapMode?: (naviMode:number) => void
返回顶部 示例中心 常见问题 智能客服 公众号
二维码