속도계 알림 구성

내비게이션이 사용 설정되어 있고 이동 모드가 운전으로 설정된 경우 iOS용 Navigation SDK는 지도의 왼쪽 하단에 현재 속도 제한을 보여주는 속도 제한 컨트롤을 표시합니다. 운전자가 속도 제한을 초과하면 컨트롤이 확장되어 속도 제한 표시 옆에 속도계가 표시되고 속도가 특정 임곗값에 도달하면 알림이 트리거됩니다.

기본적으로 Navigation SDK는 운전자가 제한 속도를 5mph (또는 10kph) 초과하면 경미한 속도 알림을 트리거하고 속도계 텍스트의 색상을 빨간색으로 변경합니다. 운전자가 제한 속도를 10mph (20km/h) 초과하면 주요 속도 알림이 트리거되고 속도계 배경 색상이 빨간색으로 변경됩니다.

알림을 트리거하는 기준점과 속도계가 표시하는 텍스트 및 배경 색상을 모두 맞춤설정할 수 있습니다. Navigation SDK를 사용하여 운전자의 속도 정보를 사용할 수도 있습니다. 예를 들어 리드셰어 운영자가 운전자가 제한 속도를 준수하고 안전을 개선하도록 유도하는 데 도움이 되도록 속도 정보를 제공할 수 있습니다.

속도 알림 기준 맞춤설정

경미한 속도 알림과 심각한 속도 알림 모두의 속도 알림 임계값을 현재 속도의 속도 제한을 초과하는 백분율로 맞춤설정할 수 있습니다. 지도에 알림이 표시되기 전에 임곗값이 초과되는 시간을 지정할 수도 있습니다.

다음 코드 예에서는 경미한 속도 알림의 기준점을 속도 제한의 5% 초과로, 심각한 속도 알림의 기준점을 속도 제한의 10% 초과로 설정합니다. 경고 임곗값이 5초 동안 초과된 후에 지도에 경고가 표시되도록 지정합니다.

Swift

let minorSpeedAlertThresholdPercentage: CGFloat = 0.05 let
majorSpeedAlertThresholdPercentage: CGFloat = 0.1 let
severityUpgradeDurationSeconds: TimeInterval = 5

// Configure SpeedAlertOptions let mutableSpeedAlertOptions:
GMSNavigationMutableSpeedAlertOptions = GMSNavigationMutableSpeedAlertOptions()
 mutableSpeedAlertOptions.setSpeedAlertThresholdPercentage(minorSpeedAlertThresholdPercentage,
for: .minor)
mutableSpeedAlertOptions.setSpeedAlertThresholdPercentage(majorSpeedAlertThresholdPercentage,
for: .major) mutableSpeedAlertOptions.severityUpgradeDurationSeconds =
severityUpgradeDurationSeconds

// Set SpeedAlertOptions to Navigator. mapView.navigator?.speedAlertOptions =
mutableSpeedAlertOptions; mapView.navigator?.add(self); // Only needed if
listening to the delegate events.

Objective-C

static const CGFloat minorSpeedAlertThresholdPercentage = 0.05; static const
CGFloat majorSpeedAlertThresholdPercentage = 0.1; static const NSTimeInterval
severityUpgradeDurationSeconds = 5;

// Configure SpeedAlertOptions GMSNavigationMutableSpeedAlertOptions
*mutableSpeedAlertOptions = [[GMSNavigationMutableSpeedAlertOptions alloc]
init]; [mutableSpeedAlertOptions setSpeedAlertThresholdPercentage:
minorSpeedAlertThresholdPercentage
forSpeedAlertSeverity:GMSNavigationSpeedAlertSeverityMinor];
[mutableSpeedAlertOptions
setSpeedAlertThresholdPercentage:majorSpeedAlertThresholdPercentage
forSpeedAlertSeverity:GMSNavigationSpeedAlertSeverityMajor];
[mutableSpeedAlertOptions
setSeverityUpgradeDurationSeconds:severityUpgradeDurationSeconds];

// Set SpeedAlertOptions to Navigator. mapView.navigator.speedAlertOptions =
mutableSpeedAlertOptions; [mapView.navigator addListener:self]; // Only needed
if listening to the delegate events.

속도계에서 속도 알림을 표시하는 방식 맞춤설정

각 알림 수준에 맞게 속도계 디스플레이의 색상을 맞춤설정할 수 있습니다.

다음 표에는 GMSNavigationSpeedometerUIOptions 클래스의 속도 알림 기본 색상이 나와 있습니다.

요소색상
MinorSpeedAlertBackgroundColorDayMode 0xffffff(흰색)
MinorSpeedAlertBackgroundColorNightMode 0x000000
MinorSpeedAlertTextColorDayMode 0xd93025
MinorSpeedAlertTextColorNightMode 0xd93025
MajorSpeedAlertBackgroundColorDayMode 0xd93025
MajorSpeedAlertBackgroundColorNightMode 0xd93025
MajorSpeedAlertTextColorDayMode 0xffffff(흰색)
MajorSpeedAlertTextColorNightMode 0xffffff(흰색)

경미한 속도 알림과 심각한 속도 알림 모두에 대해 속도계의 텍스트와 배경 색상을 지정할 수 있습니다.

Swift

let mutableSpeedometerUIOptions: GMSNavigationMutableSpeedometerUIOptions =
GMSNavigationMutableSpeedometerUIOptions()
mutableSpeedometerUIOptions.setTextColor(minorSpeedAlertTextColor, for: .minor,
lightingMode: .normal)
mutableSpeedometerUIOptions.setTextColor(majorSpeedAlertTextColor, for: .major,
lightingMode: .normal)
mutableSpeedometerUIOptions.setBackgroundColor(minorSpeedAlertNightModeBackgroundColor,
for: .minor, lightingMode: .lowLight)
mutableSpeedometerUIOptions.setBackgroundColor(majorSpeedAlertDayModeBackgroundColor,
for: .major, lightingMode: .normal)

mapView.settings.speedometerUIOptions = mutableSpeedometerUIOptions

Objective-C

GMSNavigationMutableSpeedometerUIOptions *mutableSpeedometerUIOptions =
[[GMSNavigationMutableSpeedometerUIOptions alloc] init];
[mutableSpeedometerUIOptions setTextColor: minorSpeedAlertTextColor
forSpeedAlertSeverity: GMSNavigationSpeedAlertSeverityMinor lightingMode:
GMSNavigationLightingModeNormal]; [mutableSpeedometerUIOptions setTextColor:
majorSpeedAlertTextColor forSpeedAlertSeverity:
GMSNavigationSpeedAlertSeverityMajor lightingMode:
GMSNavigationLightingModeNormal]; [mutableSpeedometerUIOptions
setBackgroundColor: minorSpeedAlertNightModeBackgroundColor
forSpeedAlertSeverity: GMSNavigationSpeedAlertSeverityMinor lightingMode:
GMSNavigationLightingModeLowLight]; [mutableSpeedometerUIOptions
setBackgroundColor: majorSpeedAlertDayModeBackgroundColor forSpeedAlertSeverity:
GMSNavigationSpeedAlertSeverityMajor
lightingMode:GMSNavigationLightingModeNormal];

mapView.settings.speedometerUIOptions = mutableSpeedometerUIOptions;

운전자로부터 속도 정보 수신

애플리케이션에서 운전자 속도에 관한 정보를 공유해야 하는 경우 Navigation SDK를 사용하여 운전자의 속도 정보를 사용할 수 있습니다. 이는 운영자가 안전을 개선하기 위해 운전자의 과속을 모니터링하려는 차량 공유 애플리케이션에 유용할 수 있습니다.

예를 들어 다음 예에서는 속도가 속도 제한을 초과하는 지정된 비율인 경우 속도 정보를 공유합니다.

Swift

// Listener method for sharing speed information when the speed exceeds the
speed limit by a specified percentage. #pragma mark GMSNavigatorListener func
navigator(_ navigator : GMSNavigator, didUpdateSpeedingPercentage
percentageAboveLimit : Float) { ... }

Objective-C

// Listener method listening to speeding feed. #pragma mark
GMSNavigatorListener - (void)navigator:(GMSNavigator *)navigator
didUpdateSpeedingPercentage:(float)percentageAboveLimit { ... }