配置速度计提醒

启用导航功能后,Navigation SDK for Android 会在地图的左下角显示一个限速控件,其中会显示当前的限速。如果用户超速,该控件会展开,在限速显示旁边显示一个速度表,并在速度达到特定阈值时触发提醒。

默认情况下,当用户超速 5 英里/小时(或 10 公里/小时)时,Navigation SDK 会触发轻微超速提醒,并将速度表文本的颜色更改为红色。当用户超速 10 英里/小时(或 20 公里/小时)时,它会触发严重超速提醒,并将速度表背景颜色更改为红色。

您可以自定义触发提醒的阈值,以及速度表显示的文本和背景颜色。您还可以使用 Navigation SDK,根据您设置的阈值提供用户的速度信息。例如,您可以向网约车运营商提供速度信息,以帮助他们鼓励用户遵守限速并提高安全性。

自定义超速提醒的阈值

您可以自定义轻微超速提醒和严重超速提醒的超速提醒阈值,以当前速度的限速百分比表示。您还可以指定在超出阈值多长时间后,地图会显示提醒。

以下代码示例将轻微超速提醒的阈值设置为超速 5%,并将严重超速提醒的阈值设置为超速 10%。它指定在超出提醒阈值 5 秒后,地图会显示提醒。


 float minorSpeedAlertThresholdPercentage = 5; float
majorSpeedAlertThresholdPercentage = 10; double severityUpgradeDurationSeconds =
5;

 // Configure SpeedAlertOptions SpeedAlertOptions.Builder
speedAlertOptionsBuilder = new SpeedAlertOptions.Builder();
speedAlertOptionsBuilder.setSpeedAlertThresholdPercentage(
SpeedAlertSeverity.MINOR, minorSpeedAlertThresholdPercentage);
speedAlertOptionsBuilder.setSpeedAlertThresholdPercentage(
SpeedAlertSeverity.MAJOR, majorSpeedAlertThresholdPercentage);
speedAlertOptionsBuilder.setSeverityUpgradeDurationSeconds(severityUpgradeDurationSeconds);

 // Set SpeedAlertOptions to Navigator.
navigator.setSpeedAlertOptions(speedAlertOptionsBuilder.build());

自定义速度表显示超速提醒的方式

为了让超速提醒更醒目,您可以为每个提醒级别自定义速度表显示的颜色。

下表显示了 NavigationView 类中超速提醒的默认颜色:

元素颜色
MinorSpeedAlertBackgroundColorDayMode 0xffffff(白色)
MinorSpeedAlertBackgroundColorNightMode 0x000000
MinorSpeedAlertTextColorDayMode 0xd93025
MinorSpeedAlertTextColorNightMode 0xd93025
MajorSpeedAlertBackgroundColorDayMode 0xd93025
MajorSpeedAlertBackgroundColorNightMode 0xd93025
MajorSpeedAlertTextColorDayMode 0xffffff(白色)
MajorSpeedAlertTextColorNightMode 0xffffff(白色)

您可以为轻微超速提醒和严重超速提醒指定速度表的文本和背景颜色:

 SpeedometerUiOptions speedometerUiOptions = new SpeedometerUiOptions.Builder()
 .setBackgroundColorDayMode(MINOR, some_color)
.setBackgroundColorNightMode(MINOR, some_color) .setTextColorDayMode(MINOR,
some_color) .setTextColorNightMode(MINOR, some_color)
.setBackgroundColorDayMode(MAJOR, some_color)
.setBackgroundColorNightMode(MAJOR, some_color) .setTextColorDayMode(MAJOR,
some_color) .setTextColorNightMode(MAJOR, some_color) .build();

 // Set SpeedometerUiOptions to NavigationView.
navigationView.setSpeedometerUiOptions(speedometerUiOptionsBuilder.build());
navigationView.setSpeedometerEnabled(true);

 // Set SpeedometerUiOptions to SupportNavigationFragment.
supportNavigationFragment.setSpeedometerUiOptions(speedometerUiOptionsBuilder.build());
 supportNavigationFragment.setSpeedometerEnabled(true);

接收用户的速度信息

如果您的应用需要分享用户速度信息,您还可以使用 Navigation SDK 来提供用户的速度信息。例如,这对于网约车应用非常有用,因为运营商可能希望监控用户是否超速,以提高安全性。您还可以通过这种方式来提供速度信息,而无需在应用中向用户呈现导航视图。

例如,以下示例会在速度超过限速的指定百分比时分享速度信息:

 // Existing flow for creating Navigator. NavigationApi.getNavigator();

 // Set the SpeedAlertOptions for the MAJOR and MINOR alerts. (Note that the //
severityUpgradeDurationSeconds field is by design not used in this flow.)
SpeedAlertOptions speedAlertOptions = ...;
navigator.setSpeedAlertOptions(speedAlertOptions);

 // Implement SpeedingListener. SpeedingListener speedingListener = new
SpeedingListener() { @Override public void onSpeedingUpdated(float
percentageAboveLimit, SpeedAlertSeverity speedAlertSeverity) { ... } };

 // Set speedingListener to Navigator.
navigator.setSpeedingListener(speedingListener);