Dostosuj linie łamane trasy

Wybierz platformę: Android iOS JavaScript

Zanim dostosujesz linie łamane (lub znaczniki) trasy, musisz najpierw zainicjować opcje dostosowywania interfejsu.

Inicjowanie opcji dostosowywania interfejsu

Zalecany wywołanie zwrotne używane do wstępnego ustawienia opcji dostosowywania interfejsu jest zadeklarowane w GMTCMapViewDelegate. Wywołanie zwrotne mapViewDidInitialize jest wywoływane, gdy obiekt GMTCMapView jest gotowy do renderowania mapy. Koordynator stylu jest zainicjowany, ale nie ma żadnych elementów interfejsu.

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

Dostosowywanie linii łamanych

Dostosowywanie linii łamanej jest ustawiane za pomocą GMTCConsumerMapStyleCoordinator#setPolylineStyleOptions(_:polylineType:).

Poniższy przykład pokazuje, jak ustawić opcje stylu linii łamanej:

Typy linii łamanych

Możesz dostosować te typy linii łamanych:

  • GMTCPolylineType.activeRoute: trasa, którą pojazd jedzie do następnego punktu pasażera, niezależnie od tego, czy jest to miejsce odbioru czy docelowe.
  • GMTCPolylineType.remainingRoute: odcinek podróży, który pozostał po tym, jak pojazd pokonał trasę GMTCPolylineType.activeRoute.

Oba te typy są wyświetlane podczas wspólnej podróży.

Właściwości linii łamanej

Właściwości, które możesz dostosować dla każdej linii łamanej, to podzbiór właściwości dostępnych w Mapach Google PolylineOptions. Właściwości GMTCPolylineStyleOptions pakietu SDK dla konsumentów mają te cechy:

  • Zbudowane przy użyciu inicjatora.
  • Mogą być niezmienne lub zmienne, jeśli chcesz podać niestandardowe wartości dowolnej właściwości.
  • Mają wartości domyślne.

Możesz dostosować te właściwości:

  • color
  • width
  • isVisible: aby wyłączyć linię łamaną, ustaw isVisible na false.
  • isTrafficEnabled: ta właściwość jest domyślnie ustawiona na false.

Przykład

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

Linie łamane uwzględniające ruch drogowy

Warstwa ruchu drogowego linii łamanej jest domyślnie wyłączona. Gdy włączysz ją za pomocą polylineStyleOptions.isTrafficEnabled = true, odcinki reprezentujące fragmenty ruchu drogowego inne niż normalne są rysowane jako trasa.

Warunki na drodze są reprezentowane przez jedną z 4 prędkości:

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

Kolor reprezentujący każdą z tych klasyfikacji prędkości możesz dostosować za pomocą setTrafficColorFor(_:color:).