Khi bạn bật tính năng chỉ đường, Navigation SDK cho Android sẽ hiển thị một nút điều khiển giới hạn tốc độ ở góc dưới bên trái của bản đồ, cho biết giới hạn tốc độ hiện tại. Nếu người dùng vượt quá giới hạn tốc độ, thì chế độ điều khiển sẽ mở rộng để hiển thị đồng hồ tốc độ bên cạnh màn hình giới hạn tốc độ và kích hoạt cảnh báo khi tốc độ đạt đến một ngưỡng nhất định.
Theo mặc định, SDK điều hướng sẽ kích hoạt một cảnh báo tốc độ nhỏ khi người dùng vượt quá giới hạn tốc độ khoảng 5 dặm/giờ (hoặc 10 km/giờ) và thay đổi màu văn bản trên đồng hồ tốc độ thành màu đỏ. Tính năng này sẽ kích hoạt cảnh báo tốc độ lớn khi người dùng vượt quá giới hạn tốc độ 10 dặm/giờ (hoặc 20 km/giờ) và thay đổi màu nền của đồng hồ tốc độ thành màu đỏ.
Bạn có thể tuỳ chỉnh cả ngưỡng kích hoạt cảnh báo cũng như văn bản và màu nền mà đồng hồ tốc độ hiển thị. Bạn cũng có thể sử dụng SDK điều hướng để cung cấp thông tin về tốc độ của người dùng theo các ngưỡng bạn đã đặt. Ví dụ: bạn có thể cung cấp thông tin về tốc độ cho các nhà điều hành dịch vụ đi chung xe để khuyến khích người dùng tuân thủ giới hạn tốc độ và cải thiện sự an toàn.
Tuỳ chỉnh ngưỡng cho cảnh báo tốc độ
Bạn có thể tuỳ chỉnh ngưỡng cảnh báo tốc độ cho cả cảnh báo tốc độ nhỏ và lớn dưới dạng tỷ lệ phần trăm trên giới hạn tốc độ của tốc độ hiện tại. Bạn cũng có thể chỉ định khoảng thời gian vượt quá ngưỡng trước khi bản đồ hiển thị cảnh báo.
Ví dụ về mã sau đây đặt ngưỡng cho cảnh báo tốc độ nhỏ là 5% vượt quá giới hạn tốc độ và ngưỡng cho cảnh báo tốc độ lớn là 10% vượt quá giới hạn tốc độ. Thuộc tính này chỉ định rằng bản đồ sẽ hiển thị cảnh báo sau khi vượt quá ngưỡng cảnh báo trong 5 giây.
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());
Tuỳ chỉnh cách đồng hồ tốc độ hiển thị cảnh báo tốc độ
Để cảnh báo tốc độ thu hút sự chú ý hơn, bạn có thể tuỳ chỉnh màu sắc của màn hình đồng hồ tốc độ cho từng cấp độ cảnh báo.
Bảng sau đây trình bày các màu mặc định cho cảnh báo tốc độ trong lớp NavigationView:
| Phần tử | Màu |
|---|---|
| MinorSpeedAlertBackgroundColorDayMode | 0xffffff(trắng) |
| MinorSpeedAlertBackgroundColorNightMode | 0x000000 |
| MinorSpeedAlertTextColorDayMode | 0xd93025 |
| MinorSpeedAlertTextColorNightMode | 0xd93025 |
| MajorSpeedAlertBackgroundColorDayMode | 0xd93025 |
| MajorSpeedAlertBackgroundColorNightMode | 0xd93025 |
| MajorSpeedAlertTextColorDayMode | 0xffffff(trắng) |
| MajorSpeedAlertTextColorNightMode | 0xffffff(trắng) |
Bạn có thể chỉ định văn bản và màu nền của đồng hồ tốc độ cho cả cảnh báo tốc độ nhỏ và chính:
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);
Nhận thông tin về tốc độ từ người dùng
Nếu ứng dụng của bạn yêu cầu chia sẻ thông tin về tốc độ của người dùng, bạn cũng có thể sử dụng SDK Điều hướng để cung cấp thông tin về tốc độ của người dùng. Ví dụ: tính năng này có thể hữu ích cho các ứng dụng đi chung xe, trong đó nhà điều hành có thể muốn theo dõi việc người dùng lái xe quá tốc độ để cải thiện sự an toàn. Bạn cũng có thể thực hiện việc này mà không cần hiển thị thành phần hiển thị điều hướng cho người dùng trong ứng dụng.
Ví dụ: ví dụ sau đây chia sẻ thông tin về tốc độ khi tốc độ là một tỷ lệ phần trăm đã chỉ định so với giới hạn tốc độ:
// 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);