啟用導航功能後,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 | 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);