Configurer les alertes du compteur de vitesse

Lorsque la navigation est activée, le SDK Navigation pour iOS affiche une commande de limitation de vitesse dans l'angle inférieur gauche de la carte, qui indique la limitation de vitesse actuelle. Si un conducteur dépasse la limite de vitesse, la commande se développe pour afficher un compteur de vitesse à côté de l'affichage de la limite de vitesse et déclencher des alertes lorsque la vitesse atteint un certain seuil.

Par défaut, le SDK Navigation déclenche une alerte de vitesse mineure lorsque le conducteur dépasse la limite de vitesse de 5 mph (ou 10 km/h) et change la couleur du texte du compteur de vitesse en rouge. Il déclenche une alerte de vitesse majeure lorsque le conducteur dépasse la limite de vitesse de 10 mph (ou 20 km/h) et définit la couleur d'arrière-plan du compteur de vitesse en rouge.

Vous pouvez personnaliser à la fois le seuil de déclenchement des alertes et les couleurs de texte et d'arrière-plan affichées par le compteur de vitesse. Vous pouvez également utiliser le SDK Navigation pour rendre disponibles les informations sur la vitesse du conducteur. Par exemple, vous pouvez mettre à la disposition des opérateurs de VTC des informations sur la vitesse pour les aider à encourager leurs conducteurs à respecter la limite de vitesse et à améliorer la sécurité.

Personnaliser des seuils pour les alertes de vitesse

Vous pouvez personnaliser le seuil des alertes de vitesse mineures et majeures sous la forme d'un pourcentage supérieur à la limite de vitesse de la vitesse actuelle. Vous pouvez également spécifier la durée pendant laquelle le seuil est dépassé avant que la carte n'affiche l'alerte.

Dans l'exemple de code suivant, le seuil d'une alerte de vitesse mineure est supérieur de 5 % à la limite de vitesse, et le seuil d'une alerte de vitesse majeure sur 10 % de la limite de vitesse. Il indique que la carte affiche une alerte après cinq secondes de dépassement d'un seuil d'alerte.

Swift

Let minorSpeedAlertThresholdPercentage: CGFloat = 0.05 let majorSpeedAlertThresholdPercentage: CGFloat = 0.1 let depthUpgradeDurationseconds: TimeInterval = 5

// Définissez SpeedAlertOptions sur Navigator. mapView.navigator?.speedAlertOptions = mutableSpeedAlertOptions; mapView.navigator?.add(self); // N'est nécessaire que si vous écoutez les événements du délégué.

Objective-C

statique const CGFloat mineurSpeedAlertThresholdPercentage = 0.05; statique const CGFloat majorSpeedAlertThresholdPercentage = 0.1; statique const NSTimeInterval depthUpgradeDurationSecond = 5;

// Définissez SpeedAlertOptions sur Navigator. mapView.navigator.speedAlertOptions = mutableSpeedAlertOptions; [mapView.navigator addListener:self]; // Nécessaire uniquement si vous écoutez les événements du délégué.

Personnaliser l'affichage des alertes de vitesse sur le compteur de vitesse

Vous pouvez personnaliser les couleurs du compteur de vitesse pour chaque niveau d'alerte.

Le tableau suivant indique les couleurs par défaut pour les alertes de vitesse dans la classe GMSNavigationSpeedometerUIOptions:

ÉlémentCouleur
MinorSpeedAlertBackgroundColorDayMode 0xffffff(blanc)
MinorSpeedAlertBackgroundColorNightMode 0x000000
MinorSpeedAlertTextColorDayMode 0XD93025
MinorSpeedAlertTextColorNightMode 0XD93025
MajorSpeedAlertBackgroundColorDayMode 0XD93025
MajorSpeedAlertBackgroundColorNightMode 0XD93025
MajorSpeedAlertTextColorDayMode 0xffffff(blanc)
MajorSpeedAlertTextColorNightMode 0xffffff(blanc)

Vous pouvez spécifier la couleur du texte et de l'arrière-plan du compteur de vitesse pour les alertes de vitesse mineures et majeures:

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.speedomètreUIOptions = mutableSpeedomètreUIOptions

Objective-C

GMSNavigationMutableSpeedModelight:Alertes

mapView.settings.speedomètreUIOptions = mutableSpeedomètreUIOptions;

Recevoir des informations sur la vitesse de la part des conducteurs

Si votre application nécessite de partager des informations sur la vitesse du conducteur, vous pouvez également utiliser le SDK Navigation pour les rendre disponibles. Cela peut être utile pour les applications de partage de course dans lesquelles un opérateur peut souhaiter surveiller les excès de vitesse des conducteurs afin d'améliorer la sécurité.

Par exemple, l'exemple suivant partage des informations sur la vitesse lorsque la vitesse est un pourcentage spécifié supérieur à la limite de vitesse:

Swift

// Méthode de l'écouteur pour partager des informations sur la vitesse lorsque celle-ci dépasse la limite de vitesse d'un pourcentage spécifié. #pragma mark GMSNavigatorListener func navigator(_ navigator : GMSNavigator, didUpdateSpeedingPercentage percentageAboveLimit : Float) { ... }

Objective-C

// Méthode de l'écouteur écoutant le flux d'excès de vitesse. #pragma mark GMSNavigatorListener - (void)navigator:(GMSNavigator *)navigator didUpdateSpeedingPercentage:(float)percentageAboveLimit { ... }