啟用導航功能後,Android 專用 Navigation SDK 會在地圖左下角顯示速限控制項,指出目前的速限。如果使用者超過速限,控制項會展開,在速限顯示旁顯示速度計,並在速度達到特定門檻時觸發快訊。
根據預設,當使用者超速 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 NavigationFragment.
navigationFragment.setSpeedometerUiOptions(speedometerUiOptionsBuilder.build());
navigationFragment.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);