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

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

Полилинии маршрута настраиваются с помощью метода ConsumerMapStyle.setPolylineStyleOptions . Если вы зададите пользовательские параметры полилинии, они переопределят значения по умолчанию, предоставляемые Consumer SDK.

Чтобы восстановить значения по умолчанию , вызовите setPolylineStyleOptions , указав null для параметра PolylineOptions .

Чтобы получить активные PolylineOptions , используйте метод getPolylineStyleOptions .

Для получения дополнительной информации см. ConsumerMapStyle.setPolylineStyleOptions .

Типы полилиний маршрута

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

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

ACTIVE_ROUTE и REMAINING_ROUTE отображаются во время следования по маршруту и ​​представляют собой маршрут транспортного средства .

Свойства полилинии маршрута

Google Maps предоставляет настраиваемые свойства, доступные для каждой полилинии в PolylineOptions .

  • Для построения PolylineOptions используйте его конструктор.

  • Чтобы задать пользовательские свойства , используйте методы в стиле «Setter». Поскольку метод предоставляет значения по умолчанию для каждого свойства, вам нужно указать только пользовательские значения.

  • Чтобы отключить полилинию , установите visible на false .

Более подробную информацию см. в разделе PolylineOptions в документации для разработчиков Android.

Пример

Ява 

// Initializing polyline style options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setPolylineStyleOptions(
              PolylineType.ACTIVE_ROUTE,
              new PolylineOptions()
                  .visible(false));
        });

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null);

Котлин 

// Initializing polyline options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    consumerMapStyle.setPolylineStyleOptions(
      PolylineType.ACTIVE_ROUTE,
      PolylineOptions().visible(false)
    )
  })

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null)

Активный и оставшийся маршрут

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

  • Активный маршрут — это путь, по которому в данный момент движется транспортное средство, чтобы достичь следующей точки маршрута в активном маршруте потребителя.

  • Оставшийся маршрут — это путь, который транспортному средству ещё предстоит пройти после активного маршрута. Если путевая точка активного маршрута является последней путевой точкой поездки, оставшийся маршрут не существует.

Вы можете настраивать и контролировать видимость активных и оставшихся полилиний в своём приложении. По умолчанию активный маршрут виден, а оставшийся — нет.

Пример

Ява 

// Initializing polyline options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setPolylineStyleOptions(
              PolylineType.ACTIVE_ROUTE,
              new PolylineOptions()
                  .color(Color.BLUE));
          consumerMapStyle.setPolylineStyleOptions(
              PolylineType.REMAINING_ROUTE,
              new PolylineOptions()
                  .color(Color.BLACK)
                  .width(5)
                  .visible(true));
        });

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null);
consumerMapStyle.setPolylineStyleOptions(PolylineType.REMAINING_ROUTE, null);

Котлин 

// Initializing polyline options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    {
      consumerMapStyle.setPolylineStyleOptions(
        PolylineType.ACTIVE_ROUTE,
        PolylineOptions().color(Color.BLUE)
      )

      consumerMapStyle.setPolylineStyleOptions(
        PolylineType.REMAINING_ROUTE,
        PolylineOptions().color(Color.BLACK).width(5).visible(true)
      )
    }
  })

// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null)

consumerMapStyle.setPolylineStyleOptions(PolylineType.REMAINING_ROUTE, null)

Полилинии с учетом дорожного движения

Слой дорожного движения на ломаной линии по умолчанию отключен. При его включении рендерер рисует над ломаной линией маршрута сегменты, представляющие участки с нестандартным движением. Смещение зависит от условий дорожного движения. Подробнее см. в документации Android Developer по ломаной линии .

На картах Google дорожная обстановка отображается в виде одного из четырёх типов скорости . Вы можете настроить цвет для каждого типа скорости.

Чтобы включить полилинии с учетом дорожного движения , создайте объект TrafficStyle , а затем передайте его в ConsumerMapStyle , вызвав setPolylineTrafficStyle() .

Пример

Ява 

// TrafficStyle is part of the Consumer SDK.
int orange = Color.rgb(255, 165, 0);
TrafficStyle trafficStyle = TrafficStyle.builder()
  .setTrafficVisibility(true)
  .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
  .setTrafficColor(SpeedType.NORMAL, Color.BLUE)
  .setTrafficColor(SpeedType.SLOW, orange)
  .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
  .build();

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle);

Котлин 

// TrafficStyle is part of the Consumer SDK.
val orange = Color.rgb(255, 165, 0)
val trafficStyle =
  TrafficStyle.builder()
    .setTrafficVisibility(true)
    .setTrafficColor(SpeedType.NO_DATA, Color.GRAY)
    .setTrafficColor(SpeedType.NORMAL, Color.BLUE)
    .setTrafficColor(SpeedType.SLOW, orange)
    .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
    .build()

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle)