Polylinien für Routen anpassen

Plattform auswählen: Android iOS JavaScript

Bevor Sie Routen-Polylinien (oder Markierungen) anpassen, müssen Sie die Optionen für die UI-Anpassung initialisieren.

Optionen zur Anpassung der Benutzeroberfläche initialisieren

Der empfohlene Callback, der zum anfänglichen Festlegen der Optionen für die UI-Anpassung verwendet wird, wird in der GMTCMapViewDelegate deklariert. Der mapViewDidInitialize-Callback wird ausgelöst, wenn das GMTCMapView-Objekt bereit ist, die Karte zu rendern. Der Stilkoordinator ist initialisiert, aber es sind keine UI-Elemente vorhanden.

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

Polylinien anpassen

Die Polylinienanpassung wird mit GMTCConsumerMapStyleCoordinator#setPolylineStyleOptions(_:polylineType:) festgelegt.

Im folgenden Beispiel wird gezeigt, wie Sie Stiloptionen für Polylinien festlegen:

Polylinientypen

Sie können die folgenden Polylinientypen anpassen:

  • GMTCPolylineType.activeRoute: Die Route, die das Fahrzeug zum nächsten Punkt des Fahrgasts nimmt, unabhängig davon, ob es sich um den Abhol- oder den Zielort handelt.
  • GMTCPolylineType.remainingRoute: Der Teil der Fahrt, der übrig bleibt, nachdem das Fahrzeug die GMTCPolylineType.activeRoute abgeschlossen hat.

Beide Typen werden während einer gemeinsamen Fahrt angezeigt.

Polylinien-Eigenschaften

Die Eigenschaften, die Sie für jede Polylinie anpassen können, sind eine Teilmenge der Eigenschaften, die in Google Maps PolylineOptions bereitgestellt werden. Die Consumer SDK-Eigenschaften GMTCPolylineStyleOptions haben die folgenden Merkmale:

  • Mit einem Initialisierer erstellt.
  • Kann unveränderlich oder veränderlich sein, wenn Sie benutzerdefinierte Werte für ein Attribut angeben möchten.
  • Standardwerte haben.

Sie können die folgenden Eigenschaften anpassen:

  • color
  • width
  • isVisible: Wenn Sie eine Polylinie deaktivieren möchten, setzen Sie isVisible auf false.
  • isTrafficEnabled: Dieses Attribut ist standardmäßig auf false festgelegt.

Beispiel

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];
}

Verkehrsabhängige Polylinien

Die Verkehrsebene der Polylinie ist standardmäßig deaktiviert. Wenn Sie sie mit polylineStyleOptions.isTrafficEnabled = true aktivieren, werden Segmente, die Strecken mit ungewöhnlichem Verkehrsaufkommen darstellen, als Route gezeichnet.

Die Verkehrslage wird durch eine von vier Geschwindigkeiten dargestellt:

  • GMTSSpeedType.noData
  • GMTSSpeedType.normal
  • GMTSSpeedType.slow
  • GMTSSpeedType.trafficJam

Sie können die Farbe für jede dieser Geschwindigkeitsklassen mit setTrafficColorFor(_:color:) anpassen.