Настройка полилиний маршрута

Выберите платформу: Android iOS JavaScript

Прежде чем настраивать полилинии маршрута (или маркеры), сначала необходимо инициализировать параметры настройки пользовательского интерфейса.

Инициализация параметров настройки пользовательского интерфейса

Рекомендуемый обратный вызов, используемый для первоначальной установки параметров настройки пользовательского интерфейса, объявлен в GMTCMapViewDelegate . Обратный вызов mapViewDidInitialize запускается, когда объект GMTCMapView готов отобразить карту. Координатор стилей инициализирован, но элементы пользовательского интерфейса отсутствуют.

Быстрый 

/** ViewController.swift */

class ViewController: UIViewController, GMTCMapViewDelegate {

  // MARK: - GMTCMapViewDelegate

  func mapViewDidInitialize(_ mapview: GMTCMapView) {
    // Set the UI customization options here.
  }
}

Цель-C 

/** ViewController.m */

@interface ViewController () <GMTCMapViewDelegate>

#pragma mark GMTCMapViewDelegate

- (void)mapViewDidInitialize:(GMTCMapView *)mapview {
  // Set the UI customization options here.
}

Настройка полилиний

Настройка полилинии задается с помощью GMTCConsumerMapStyleCoordinator#setPolylineStyleOptions(_:polylineType:) .

В следующем примере показано, как задать параметры стиля полилинии:

Типы полилиний

Вы можете настроить следующие типы полилиний:

  • GMTCPolylineType.activeRoute : маршрут, по которому транспортное средство следует до следующей точки водителя, будь то посадка или высадка.
  • GMTCPolylineType.remainingRoute : сегмент поездки, который остается после того, как транспортное средство завершает GMTCPolylineType.activeRoute .

Оба этих типа отображаются на протяжении всего совместного путешествия.

Свойства полилинии

Свойства, которые вы можете настроить для каждой полилинии, являются подмножеством свойств, представленных в PolylineOptions Google Maps. Свойства Consumer SDK GMTCPolylineStyleOptions имеют следующие особенности:

  • Построен с использованием инициализатора.
  • Может быть неизменяемым или изменяемым, если вы хотите предоставить собственные значения для любого свойства.
  • Иметь значения по умолчанию.

Вы можете настроить следующие свойства:

  • color
  • width
  • isVisible : чтобы отключить полилинию, установите для isVisible значение false .
  • isTrafficEnabled : по умолчанию для этого свойства установлено значение false .

Пример

Быстрый 

/** 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)
}

Цель-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];
}

Полилинии с учетом трафика

По умолчанию слой трафика полилинии отключен. Когда вы включаете его с помощью polylineStyleOptions.isTrafficEnabled = true , в качестве маршрута рисуются сегменты, представляющие участки необычного трафика.

Условия дорожного движения представлены в виде одной из четырех скоростей:

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

Вы можете настроить цвет, представляющий каждую из этих категорий скорости, используя setTrafficColorFor(_:color:) .