Avant de personnaliser les polylignes (ou repères) de parcours, vous devez d'abord initialiser les options de personnalisation de l'UI.
Initialiser les options de personnalisation de l'UI
Le rappel recommandé utilisé pour définir initialement les options de personnalisation de l'UI est déclaré dans GMTCMapViewDelegate
. Le rappel mapViewDidInitialize
est déclenché lorsque l'objet GMTCMapView
est prêt à afficher la carte.
Le coordinateur de style est initialisé, mais aucun élément d'interface utilisateur n'est présent.
Swift
/** ViewController.swift */
class ViewController: UIViewController, GMTCMapViewDelegate {
// MARK: - GMTCMapViewDelegate
func mapViewDidInitialize(_ mapview: GMTCMapView) {
// Set the UI customization options here.
}
}
Objective-C
/** ViewController.m */
@interface ViewController () <GMTCMapViewDelegate>
#pragma mark GMTCMapViewDelegate
- (void)mapViewDidInitialize:(GMTCMapView *)mapview {
// Set the UI customization options here.
}
Personnaliser les polylignes
La personnalisation des polylignes est définie à l'aide de GMTCConsumerMapStyleCoordinator#setPolylineStyleOptions(_:polylineType:)
.
L'exemple suivant montre comment définir les options de style de polyligne:
Types de polylignes
Vous pouvez personnaliser les types de polylignes suivants :
GMTCPolylineType.activeRoute
: itinéraire emprunté par le véhicule vers le prochain point du trajet du client, qu'il s'agisse du point de prise en charge ou de dépose.GMTCPolylineType.remainingRoute
: segment du trajet restant une fois que le véhicule a terminé leGMTCPolylineType.activeRoute
.
Ces deux types sont affichés tout au long d'un parcours partagé.
Propriétés des polylignes
Les propriétés que vous pouvez personnaliser pour chaque polyligne sont un sous-ensemble des propriétés fournies dans Google Maps PolylineOptions
.
Les propriétés du SDK client GMTCPolylineStyleOptions
ont les caractéristiques suivantes :
- Créé à l'aide d'un initialiseur.
- Elle peut être immuable ou non si vous souhaitez fournir des valeurs personnalisées pour n'importe quelle propriété.
- avoir des valeurs par défaut ;
Vous pouvez personnaliser les propriétés suivantes :
color
width
isVisible
: pour désactiver une polyligne, définissezisVisible
surfalse
.isTrafficEnabled
: cette propriété est définie par défaut surfalse
.
Exemple
Swift
/** MapViewController.swift */
private func updatePolylineUIOptions() {
// Get the GMTCConsumerMapStyleCoordinator
let consumerMapStyleCoordinator = mapView.consumerMapStyleCoordinator
// The polyline type that you would like to set custom UI options for.
let customizablePolylineType = GMTCPolylineType.activeRoute
// Initializing polyline options with default values (immutable version).
let polylineStyleOptions = GMTCPolylineStyleOptions()
consumerMapStyleCoordinator.setPolylineStyleOptions(
polylineStyleOptions, polylineType: customizablePolylineType)
// Initializing polyline options with custom values (mutable version).
let mutablePolylineStyleOptions = GMTCMutablePolylineStyleOptions()
mutablePolylineStyleOptions.isVisible = true
mutablepolylineStyleOptions.strokeWidth = 8.0
mutablepolylineStyleOptions.strokeColor = .blue
mutablepolylineStyleOptions.zIndex = 1000
mutablepolylineStyleOptions.isGeodesic = true
mutablePolylineStyleOptions.isTrafficEnabled = true
mutablePolylineStyleOptions.setTrafficColorFor(.slow, color: .yellow)
mutablePolylineStyleOptions.setTrafficColorFor(.trafficJam, color: .purple)
consumerMapStyleCoordinator.setPolylineStyleOptions(
mutablePolylineStyleOptions, polylineType: customizablePolylineType)
// Reset polyline options to default values.
consumerMapStyleCoordinator.setPolylineStyleOptions(
nil, polylineType: customizablePolylineType)
}
Objective-C
/** MapViewController.m */
- (void)updatePolylineUIOptions {
// Get the GMTCConsumerMapStyleCoordinator
GMTCConsumerMapStyleCoordinator *consumerMapStyleCoordinator = [_mapView consumerMapStyleCoordinator];
// The polyline type that you would like to set custom UI options for.
GMTCPolylineType customizablePolylineType = GMTCPolylineTypeActiveRoute;
// Initializing polyline options with default values (immutable version).
GMTCPolylineStyleOptions *polylineStyleOptions = [[GMTCPolylineStyleOptions alloc] init];
[consumerMapStyleCoordinator setPolylineStyleOptions:polylineStyleOptions
polylineType:customizablePolylineType];
// Initializing polyline options with custom values (mutable version).
GMTCMutablePolylineStyleOptions *mutablePolylineStyleOptions = [[GMTCMutablePolylineStyleOptions alloc] init];
mutablePolylineStyleOptions.isVisible = YES;
mutablepolylineStyleOptions.strokeWidth = 8.0;
mutablepolylineStyleOptions.strokeColor = [UIColor blueColor];
mutablepolylineStyleOptions.zIndex = 1000;
mutablepolylineStyleOptions.isGeodesic = YES;
mutablePolylineStyleOptions.isTrafficEnabled = YES;
[mutablePolylineStyleOptions setTrafficColorForSpeed:GMTSSpeedTypeSlow color:[UIColor yellowColor]];
[mutablePolylineStyleOptions setTrafficColorForSpeed:GMTSSpeedTypeTrafficJam color:[UIColor purpleColor]];
[consumerMapStyleCoordinator setPolylineStyleOptions:mutablePolylineStyleOptions
polylineType:customizablePolylineType];
// Reset polyline options to default values.
[consumerMapStyleCoordinator setPolylineStyleOptions:nil
polylineType:customizablePolylineType];
}
Polylignes tenant compte du trafic
Le calque de trafic de la polyligne est désactivé par défaut. Lorsque vous l'activez à l'aide de polylineStyleOptions.isTrafficEnabled = true
, des segments représentant des portions de trafic anormal sont dessinés en tant qu'itinéraire.
Les conditions de circulation sont représentées par l'une des quatre vitesses suivantes :
GMTSSpeedType.noData
GMTSSpeedType.normal
GMTSSpeedType.slow
GMTSSpeedType.trafficJam
Vous pouvez personnaliser la couleur représentant chacune de ces classifications de vitesse à l'aide de setTrafficColorFor(_:color:)
.