设置速度计提醒

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