設定速度計快訊

啟用導航功能後,Navigation SDK for Android 會在地圖的左下角顯示速限控制項,顯示目前的速限。如果使用者超速,控制項會展開,並在限速顯示器旁顯示車速表,並在車速達到特定門檻時觸發警報。

根據預設,當使用者超速 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 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);