支持 NavigationFragment

public class SupportNavigationFragment 扩展 Fragment

应用中的导航组件。此 fragment 是在应用中使用导航的最简单方法。它是导航地图视图的封装容器,可自动处理必要的生命周期需求。作为 Fragment,只需使用下面的 XML 即可将此组件添加到 Activity 的布局文件中。

 <fragment
    class="com.google.android.libraries.navigation.SupportNavigationFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

公共构造函数摘要

公共方法摘要

摄像头
getCamera()
返回可用于更改地图的视口的镜头对象。
NavigationMap
getMap()
用于返回一个对象,该对象可用于向地图添加内容。
void
onConfigurationChanged(配置配置)
查看
onCreateView(LayoutInflater 膨胀器、ViewGroup 容器、Bundle savedInstanceState)
void
void
void
void
void
onSaveInstanceState(Bundle outState)
void
void
onStop()
void
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
覆盖导航期间 ETA 宣传信息的默认显示模式。
void
setCalloutInfoFormatOverride(RouteCalloutInfoFormat calloutInfoFormatOverride)
设置路线标注的标注信息格式模式。
void
setCompassEnabled(已启用布尔值)
设置罗盘是否可见。
void
setCustomControl(视图控件,CustomControlPosition 位置)
用于设置将显示在导航界面中的指定位置的自定义控件视图。
void
setEtaCardEnabled(已启用布尔值)
设置在导航期间是否显示预计到达时间卡片。
void
setForceNightMode(int forceNightMode)
void
setHeaderEnabled(已启用布尔值)
设置在导航期间是否显示精细导航标题。
void
setOnNightModeChangedListenerNavigationView.OnNightModeChangedListener 监听器)
设置监听器,当界面进入或退出夜间模式时收到通知。
void
setOnRecenterButtonClickedListenerNavigationView.OnRecenterButtonClickedListener 监听器)
设置监听器,点击“重新居中”按钮时将收到通知。
void
setRecenterButtonEnabled(已启用布尔值)
设置是否应显示重置中心按钮。
void
setSpeedAlertOptions(SpeedAlertOptions speedAlertOptions)
设置 SpeedAlertOptions,用于自定义 SpeedAlertSeverity 的触发阈值。
void
setSpeedLimitIconEnabled(已启用布尔值)
指定是否显示速度限制图标。
void
setSpeedometerIconEnabled(已启用布尔值)
指定是否显示速度计图标。
void
setSpeedometerUiOptions(SpeedometerUiOptions speedAlertUiOptions)
根据 SpeedAlertSeverity 设置速度计界面配置 SpeedometerUiOptions
void
setStylingOptions(StylingOptions stylingOptions)
为导航界面设置一些样式选项。
void
setTrafficIncidentCardsEnabled(已启用布尔值)
设置是否应在用户点击交通事故图标时显示交通事故卡片。
void
setTrafficPromptsEnabled(已启用布尔值)
设置是否应显示流量提示。

继承的方法摘要

公共构造函数

public SupportNavigationFragment ()

公共方法

public 相机 getCamera ()

返回可用于更改地图的视口的镜头对象。

返回
  • 与此 fragment 相关联的 Camera 对象

public NavigationMap getMap ()

用于返回一个对象,该对象可用于向地图添加内容。

public void onConfigurationChanged (配置配置)

参数
config

public 查看 onCreateView (LayoutInflater 增强器, ViewGroup 容器, Bundle savedInstanceState)

参数
膨胀器
容器
savedInstanceState

public void onDestroyView ()

public void onLowMemory ()

public void onPause ()

public void onResume ()

public void onSaveInstanceState (Bundle outState)

参数
outState

public void onStart ()

public void onStop ()

public void setCalloutInfoDisplayModeOverride (NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)

覆盖导航期间 ETA 宣传信息的默认显示模式。传递 null 会重置默认显示模式。

参数
calloutInfoDisplayModeOverride 所需的新显示模式。

public void setCalloutInfoFormatOverride (RouteCalloutInfoFormat calloutInfoFormatOverride)

设置路线标注的标注信息格式模式。如果未调用此方法,宣传信息将遵循 RouteCalloutInfoFormat.DEFAULT 定义的行为。

参数
calloutInfoFormatOverride 所需的新宣传信息格式。

public void setCompassEnabled (boolean enabled)

设置罗盘是否可见。此方法只应在界面线程上调用。

参数
已启用

public void setCustomControl (视图控件,CustomControlPosition 位置)

用于设置将显示在导航界面中的指定位置的自定义控件视图。如果指定位置已存在任何自定义控件,系统会替换该控件。使用 null 控件值调用此方法将移除位于指定位置的自定义控件。如果该控件已添加到其他位置或已有父控件,系统会忽略该控件。 此方法只应在界面线程上调用。

参数
对照组 将位于导航界面中的视图
排名 确定自定义控件相对于内置控件在界面中的位置。

public void setEtaCardEnabled (boolean enabled)

设置在导航期间是否显示预计到达时间卡片。此方法只应在界面线程上调用。

参数
已启用

public void setForceNightMode (int forceNightMode)

参数
forceNightMode

public void setHeaderEnabled (boolean enabled)

设置在导航期间是否显示精细导航标题。此方法只应在界面线程上调用。

参数
已启用

public void setOnNightModeChangedListener (NavigationView.OnNightModeChangedListener 监听器)

设置监听器,当界面进入或退出夜间模式时收到通知。此方法应仅在界面线程上调用。

注意:为了避免内存泄漏,当不再需要监听器时,应调用 setOnNightModeChangedListener(null)

参数
监听器 一个监听器,当界面进入或退出夜间模式时收到通知

public void setOnRecenterButtonClickedListener (NavigationView.OnRecenterButtonClickedListener 监听器)

设置监听器,点击“重新居中”按钮时将收到通知。此方法只应在界面线程上调用。

注意:为了避免内存泄漏,当不再需要监听器时,应调用 setOnRecenterButtonClickedListener(null)

参数
监听器 一个监听器,点击“重新居中”按钮时将收到通知

public void setRecenterButtonEnabled (boolean enabled)

设置是否应显示重置中心按钮。此方法应仅在界面线程上调用。

参数
已启用

public void setSpeedAlertOptions (SpeedAlertOptions speedAlertOptions)

设置 SpeedAlertOptions,用于自定义 SpeedAlertSeverity 的触发阈值。

您可以使用此方法为 MINORMAJOR 提醒以百分比的形式自定义速度提醒触发阈值。您还可以使用此方法来配置将速度提醒从 MINOR 升级到 MAJOR 所需的时间(以秒为单位)。

设置 null SpeedAlertOptions 或未设置任何速度提醒后,NavSDK 的默认速度提醒将会显示:当速度低于 5 英里/小时或 10 公里/小时时,速度提醒会在日间/夜间模式下分别以白色/深色背景显示红色文字;当速度超过 5 英里/小时或 10 公里/小时时,以红色背景显示白色文字。

参数
speedAlertOptions

public void setSpeedLimitIconEnabled (boolean enabled)

指定是否显示速度限制图标。请仅在界面线程上调用此方法。

启用后,在导航期间,指示道路速度限制的限速图标将显示在 开始角落处。该图标仅在有可靠速度限制数据的位置显示。如果速度计图标可见,则表示已附加速度计图标。

如果启用了“重新居中”按钮,当“重新居中”按钮显示时,速度限制图标会暂时隐藏。

注意:驾驶员必须遵循道路上所有张贴的标志,且限速图标仅供参考。无法保证速度限制数据的准确性。您可以在 Google Cloud 支持门户中提交支持请求,以报告我们的速度限制数据不准确。

参数
已启用

public void setSpeedometerIconEnabled (boolean enabled)

指定是否显示速度计图标。请仅在界面线程上调用此方法。

启用后,在导航期间,指示车辆速度的速度计图标将显示在起始角落处。如果速度限制图标可见,则表示速度限制图标已连接,速度计可以根据速度严重性显示不同的文本和背景颜色。

启用 speedomter 图标也会同时启用速度限制图标,但您可以使用 setSpeedLimitIconEnabled(boolean) 单独停用/启用速度限制图标

如果启用了“重新居中”按钮,则当“重新居中”按钮显示时,速度计图标会暂时隐藏。

参数
已启用

public void setSpeedometerUiOptions (SpeedometerUiOptions speedAlertUiOptions)

根据 SpeedAlertSeverity 设置速度计界面配置 SpeedometerUiOptions。请仅在界面线程上调用此方法。

设置 null SpeedometerUiOptions 会清除上一个(如果已设置)。如果未配置 SpeedometerUiOptions,速度计界面会回退到 NavSDK 默认配置,以针对不同 SpeedAlertSeverity 发出速度提醒:

  • 日间模式下的MINOR速度提醒:白色背景中的红色文字
  • 夜间模式下的MINOR速度提醒:深色背景中的红色文本
  • 日间模式下的MAJOR速度提醒:红色背景中的白色文字
  • 夜间模式下的MAJOR速度提醒:红色背景中的白色文本

参数
speedAlertUiOptions

public void setStylingOptions (StylingOptions stylingOptions)

为导航界面设置一些样式选项。此方法应仅在界面线程上调用。

参数
stylingOptions

public void setTrafficIncidentCardsEnabled (boolean enabled)

设置是否应在用户点击交通事故图标时显示交通事故卡片。此方法只应在界面线程上调用。

参数
已启用

public void setTrafficPromptsEnabled (boolean enabled)

设置是否应显示流量提示。系统会在导航期间定期显示路况提示,以更新用户路况信息。此方法应仅在界面线程上调用。

参数
已启用