탐색이 사용 설정되면 Android용 Navigation SDK는 현재 속도 제한을 보여주는 속도 제한 컨트롤을 지도의 왼쪽 하단에 표시합니다. 사용자가 속도 제한을 초과하면 컨트롤이 확장되어 속도 제한 표시 옆에 속도계가 표시되고 속도가 특정 기준점에 도달하면 알림이 트리거됩니다.
기본적으로 Navigation SDK는 사용자가 제한 속도를 5mph (또는 10kph) 초과하면 경미한 속도 알림을 트리거하고 속도계 텍스트의 색상을 빨간색으로 변경합니다. 사용자가 제한 속도를 10mph (또는 20kph) 초과하면 심각한 속도 알림이 트리거되고 속도계 배경색이 빨간색으로 변경됩니다.
알림을 트리거하는 기준점과 속도계에 표시되는 텍스트 및 배경색을 모두 맞춤설정할 수 있습니다. 또한 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 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);