Как настроить ломаные линии маршрута

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

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

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

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

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

Как настроить ломаные линии

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

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

Типы ломаных линий

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

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

Оба типа отображаются на протяжении всей совместной поездки.

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

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

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

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

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

Пример

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

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

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

Загруженность дорог обозначается одним из четырех цветов:

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

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