启用导航后,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);