設定速度計快訊

啟用導航後,Android 版 Navigation SDK 會在地圖的左下角顯示速度限制控制項,顯示目前的速限。如果駕駛人超出速限,控制項會展開,在速限顯示旁顯示速度計,並在速度達到特定門檻時觸發快訊。

根據預設,當驅動程式超過 5 英里/小時的速限 (或 10 公里時),Navigation SDK 會觸發小速快訊,並將速度計文字的顏色變更為紅色。如果駕駛人超過速限 10 英里/小時 (或 20 公里),並將速度計背景顏色變更為紅色,就會觸發重大速度快訊。

您可以自訂觸發快訊的門檻,以及計速器顯示的文字和背景顏色。您也可以使用 Navigation SDK,根據您設定的門檻提供驅動程式的速度資訊。舉例來說,您可以向代僱駕駛服務業者提供速度資訊,協助駕駛人遵守速限並提高安全性。

自訂速度快訊的門檻

您可以自訂微速和主要速度快訊的速度快訊門檻,做為超過目前速度速限的百分比。此外,您也可以指定地圖超過門檻後多久才會顯示快訊。

下列程式碼範例會將小速度快訊的門檻設為超過速限的 5%,並將主要速度快訊的門檻設為超過速限的 10%。它會指定地圖在超過快訊門檻五秒後顯示快訊。

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 0 x 93025
MinorSpeedAlertTextColorNightMode 0 x 93025
MajorSpeedAlertBackgroundColorDayMode 0 x 93025
MajorSpeedAlertBackgroundColorNightMode 0 x 93025
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);