应用中的导航组件。此 fragment 是在应用中使用导航的最简单方法。它是导航地图视图的封装容器,可自动处理必要的生命周期需求。作为 Fragment,只需使用下面的 XML 即可将此组件添加到 Activity 的布局文件中。
<fragment class="com.google.android.libraries.navigation.NavigationFragment" android:layout_width="match_parent" android:layout_height="match_parent"/>
继承的常量摘要
公共构造函数摘要
公共方法摘要
摄像头 |
getCamera()
返回可用于更改地图的视口的镜头对象。
|
NavigationMap |
getMap()
用于返回一个对象,该对象可用于向地图添加内容。
|
void |
onConfigurationChanged(配置配置)
|
查看 |
onCreateView(LayoutInflater 膨胀器、ViewGroup 容器、Bundle savedInstanceState)
|
void | |
void |
onPause()
|
void |
onResume()
|
void |
onSaveInstanceState(Bundle outState)
|
void |
onStart()
|
void |
onStop()
|
void |
onTrimMemory(整数级)
|
void |
setCalloutInfoDisplayModeOverride(NavigationCalloutDisplayMode calloutInfoDisplayModeOverride)
覆盖导航期间 ETA 宣传信息的默认显示模式。
|
void | |
void |
setCompassEnabled(已启用布尔值)
设置罗盘是否可见。
|
void | |
void |
setEtaCardEnabled(已启用布尔值)
设置在导航期间是否显示预计到达时间卡片。
|
void |
setForceNightMode(int forceNightMode)
|
void |
setHeaderEnabled(已启用布尔值)
设置在导航期间是否显示精细导航标题。
|
void |
setOnNightModeChangedListener(NavigationView.OnNightModeChangedListener 监听器)
设置监听器,当界面进入或退出夜间模式时收到通知。
|
void |
setOnRecenterButtonClickedListener(NavigationView.OnRecenterButtonClickedListener 监听器)
设置监听器,点击“重新居中”按钮时将收到通知。
|
void |
setRecenterButtonEnabled(已启用布尔值)
设置是否应显示重置中心按钮。
|
void |
setSpeedAlertOptions(SpeedAlertOptions speedAlertOptions)
设置
SpeedAlertOptions ,用于自定义 SpeedAlertSeverity 的触发阈值。 |
void |
setSpeedLimitIconEnabled(已启用布尔值)
指定是否显示速度限制图标。
|
void |
setSpeedometerIconEnabled(已启用布尔值)
指定是否显示速度计图标。
|
void |
setSpeedometerUiOptions(SpeedometerUiOptions speedAlertUiOptions)
根据
SpeedAlertSeverity 设置速度计界面配置 SpeedometerUiOptions 。 |
void | |
void |
setTrafficIncidentCardsEnabled(已启用布尔值)
设置是否应在用户点击交通事故图标时显示交通事故卡片。
|
void |
setTrafficPromptsEnabled(已启用布尔值)
设置是否应显示流量提示。
|
继承的方法摘要
公共构造函数
public NavigationFragment ()
公共方法
public void onConfigurationChanged (配置配置)
参数
config |
---|
public 查看 onCreateView (LayoutInflater 增强器, ViewGroup 容器, Bundle savedInstanceState)
参数
膨胀器 | |
---|---|
容器 | |
savedInstanceState |
public void onDestroy ()
public void onPause ()
public void onResume ()
public void onSaveInstanceState (Bundle outState)
参数
outState |
---|
public void onStart ()
public void onStop ()
public void onTrimMemory (整数级别)
参数
level |
---|
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
的触发阈值。
您可以使用此方法为 MINOR
和 MAJOR
提醒以百分比的形式自定义速度提醒触发阈值。您还可以使用此方法来配置将速度提醒从 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
发出速度提醒:
参数
speedAlertUiOptions |
---|
public void setStylingOptions (StylingOptions stylingOptions)
为导航界面设置一些样式选项。此方法应仅在界面线程上调用。
参数
stylingOptions |
---|
public void setTrafficIncidentCardsEnabled (boolean enabled)
设置是否应在用户点击交通事故图标时显示交通事故卡片。此方法只应在界面线程上调用。
参数
已启用 |
---|
public void setTrafficPromptsEnabled (boolean enabled)
设置是否应显示流量提示。系统会在导航期间定期显示路况提示,以更新用户路况信息。此方法应仅在界面线程上调用。
参数
已启用 |
---|