开发 HarmonyOS NEXT 导航SDK 开发指南 UI界面定制 自定义其他图面元素

自定义其他图面元素 最后更新时间: 2026年05月29日

通过AMapNaviViewOptions和其中的RouteOverlayOption,可以进行一些图面元素的自定义,包括转向箭头、电子眼、牵引线、红绿灯

转向箭头

转向箭头可以控制其显隐、颜色、宽度、是否为3D效果以及3D效果下的侧面颜色,

具体配置接口如下

/**
 * 设置路线转向箭头隐藏和显示
 *
 * @param isArrow true: 显示,false: 隐藏,默认为true
 * @since  2.2.3
 */
public setNaviArrowVisible(isArrow: boolean):  void
/**
 * 设置路线上转弯处箭头的颜色
 *
 * @param arrowColor 颜色值
 */
public setArrowColor(arrowColor: number):  void
/**
 * 设置路线上转弯处箭头的宽度,单位px 0代表默认宽度
 *
 * @param arrowColor 颜色值
 */
public setArrowWidth(arrowWidth: number):  void
/**
 * 设置是否显示3D箭头,默认显示
 * @param turnArrowIs3  true 显示,false 不显示
 * @since 2.2.3
 */
public setTurnArrowIs3D(turnArrowIs3: boolean):  void
/**
 * 设置3D箭头侧面颜色,只有显示 3D箭头情况加才有效
 * @param arrowSideColor
 * @since 2.2.3
 */
public setArrowSideColor(arrowSideColor: number):  void

电子眼

可以控制电子眼的显示和隐藏、电子眼距离的显示和隐藏

/**
 * 设置路线上的摄像头气泡是否显示。
 *
 * @param routeCameShow true代表显示,false代表不显示,默认显示
 * @since 2.2.3
 */
public setOnRouteCameShow(routeCameShow: boolean): void
/**
 * 设置电子眼的距离是否显示
 * @param show true, 显示;false,隐藏。默认隐藏
 * @since 2.2.3
 */
public setShowCameraDistance(show: boolean):  void
/**
 * 设置路线上的摄像头气泡是否显示
 *
 * @param cameraBubbleShow true代表显示,false代表不显示,默认显示
 * @deprecated 请配合 {@link RouteOverlayOptions#setOnRouteCameShow(boolean)} 与 {@link AMapNaviViewOptions#setRouteOverlayOptions(RouteOverlayOptions)} 使用
 */
public setCameraBubbleShow(cameraBubbleShow: boolean):  void

牵引线

牵引线指的是当前位置到终点的飞线,默认不显示。

牵引线指的是当前位置到终点的飞线,可以控制其显示和隐藏、颜色

/**
 * 设置是否绘制牵引线(当前位置到目的地的指引线)。默认不绘制牵引线。
 *
 * @param color 设置牵引线颜色,为ARGB格式。不显示牵引线时,颜色设置为-1即可。
 */
public setLeaderLineEnabled(color: number):  void

红绿灯

可以通过以下接口控制红绿灯的显示和隐藏

/**
 * 设置是否隐藏路线上的交通信号灯
 * @param isVisible true 显示 false 不显示 默认为显示
 * @since 2.2.3
 */
public setTrafficLightsVisible(isVisible: boolean)
返回顶部 示例中心 常见问题 智能客服 公众号
二维码