Настроить оповещения спидометра

Когда навигация включена и режим путешествия установлен на вождение, Navigation SDK для iOS отображает элемент управления ограничением скорости в левом нижнем углу карты, который показывает текущее ограничение скорости. Если водитель превышает ограничение скорости, элемент управления расширяется, отображая спидометр рядом с дисплеем ограничения скорости и запускает оповещения, когда скорость достигает определенного порога.

По умолчанию Navigation SDK активирует незначительное предупреждение о скорости, когда водитель превышает ограничение скорости на 5 миль/ч (или 10 км/ч), и меняет цвет текста спидометра на красный. Он активирует серьезное предупреждение о скорости, когда водитель превышает ограничение скорости на 10 миль/ч (или 20 км/ч), и меняет цвет фона спидометра на красный.

Вы можете настроить как порог срабатывания оповещений, так и цвета текста и фона, отображаемые спидометром. Вы также можете использовать Navigation SDK, чтобы сделать информацию о скорости водителя доступной. Например, вы можете сделать информацию о скорости доступной операторам совместных поездок, чтобы помочь им мотивировать своих водителей соблюдать ограничение скорости и повысить безопасность.

Настройка пороговых значений для оповещений о превышении скорости

Вы можете настроить порог оповещения о скорости как для незначительных, так и для значительных оповещений о скорости в виде процента сверх ограничения текущей скорости. Вы также можете указать, как долго будет превышен порог, прежде чем на карте отобразится оповещение.

Следующий пример кода устанавливает порог для незначительного оповещения о скорости на пять процентов сверх ограничения скорости, а порог для серьезного оповещения о скорости на 10 процентов сверх ограничения скорости. Он указывает, что карта отображает оповещение после превышения порога оповещения в течение пяти секунд.

Быстрый

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 :

Элемент Цвет
MinorSpeedAlertЦветФонаДневнойРежим 0xffffff(белый)
MinorSpeedAlertЦветФонаНочнойРежим 0x000000
MinorSpeedAlertTextColorDayMode 0xd93025
MinorSpeedAlertTextColorNightMode 0xd93025
MajorSpeedAlertЦветФонаДневнойРежим 0xd93025
MajorSpeedAlertЦветФонаНочнойРежим 0xd93025
MajorSpeedAlertTextColorDayMode 0xffffff(белый)
MajorSpeedAlertTextColorNightMode 0xffffff(белый)

Вы можете указать текст и цвет фона спидометра для незначительных и значительных предупреждений о превышении скорости:

Быстрый

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, чтобы сделать информацию о скорости водителя доступной. Это может быть полезно для приложений совместного использования поездок, в которых оператор может захотеть отслеживать превышение скорости водителями для повышения безопасности.

Например, в следующем примере передается информация о скорости, когда скорость превышает установленное ограничение на определенный процент:

Быстрый

// 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 { ... }