Konfigurowanie alertów dotyczących prędkościomierza

Gdy nawigacja jest włączona, a tryb podróży ustawiony na „Jazda”, w Navigation SDK dla iOS w lewym dolnym rogu mapy wyświetla się element sterujący ograniczeniem prędkości, który pokazuje aktualne ograniczenie prędkości. Jeśli kierowca przekroczy dozwoloną prędkość, kontroler rozszerzy się, aby wyświetlić prędkościomierz obok wyświetlacza limitu prędkości, i wyzwoli alerty, gdy prędkość osiągnie określony próg.

Domyślnie pakiet SDK nawigacji uruchamia alert o nieznacznym przekroczeniu prędkości, gdy kierowca przekroczy dozwoloną prędkość o 5 mph (lub 10 km/h), i zmienia kolor tekstu prędkościomierza na czerwony. Gdy kierowca przekroczy dozwoloną prędkość o 10 mph (20 km/h), zostanie wyświetlony alert o wysokiej prędkości, a tło prędkościomierza zmieni kolor na czerwony.

Możesz dostosować próg uruchamiania alertów oraz kolory tekstu i tła wyświetlane przez licznik prędkości. Możesz też użyć pakietu SDK nawigacji, aby udostępnić informacje o prędkości kierowcy. Możesz na przykład udostępnić informacje o prędkości operatorom usług przewozu osób, aby zachęcić ich kierowców do przestrzegania ograniczeń prędkości i zwiększenia bezpieczeństwa.

Dostosowywanie progów dla alertów o przekroczeniu prędkości

Możesz dostosować próg alertów o małej i dużej prędkości jako procent od limitu prędkości bieżącej prędkości. Możesz też określić, jak długo ma być przekroczony próg, zanim mapa wyświetli alert.

W tym przykładzie kodu próg dla alertu o niewielkiej prędkości jest ustawiony na 5% ponad limit prędkości, a próg dla alertu o dużej prędkości na 10% ponad limit prędkości. Określa on, że po przekroczeniu progu alertu przez 5 sekund mapa wyświetla alert.

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.

Dostosowywanie sposobu wyświetlania alertów o prędkości przez prędkościomierz

Możesz dostosować kolory wyświetlacza prędkościomierza dla każdego poziomu alertu.

W tabeli poniżej znajdziesz domyślne kolory alertów dotyczących prędkości w klasie GMSNavigationSpeedometerUIOptions:

ElementKolor
MinorSpeedAlertBackgroundColorDayMode 0xffffff(biały)
MinorSpeedAlertBackgroundColorNightMode 0x000000
MinorSpeedAlertTextColorDayMode 0xd93025
MinorSpeedAlertTextColorNightMode 0xd93025
MajorSpeedAlertBackgroundColorDayMode 0xd93025
MajorSpeedAlertBackgroundColorNightMode 0xd93025
MajorSpeedAlertTextColorDayMode 0xffffff(biały)
MajorSpeedAlertTextColorNightMode 0xffffff(biały)

Możesz określić kolor tekstu i tła prędkościomierza zarówno w przypadku alertów o niskiej, jak i wysokiej prędkości:

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;

Odbieranie informacji o prędkości od kierowców

Jeśli Twoja aplikacja wymaga udostępniania informacji o prędkości kierowcy, możesz też użyć pakietu SDK nawigacji, aby udostępnić informacje o prędkości. Może to być przydatne w przypadku aplikacji do przewozu osób, w których operator może chcieć monitorować nadmierną prędkość kierowców w celu zwiększenia bezpieczeństwa.

Na przykład w tym przykładzie udostępniane są informacje o prędkości, gdy jest ona o określony procent wyższa od limitu prędkości:

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