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

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

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

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

Дополнительные сведения см. в ConsumerMapStyle.setPolylineStyleOptions .

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

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

• ACTIVE_ROUTE
• REMAINING_ROUTE

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

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

Карты Google предоставляют настраиваемые свойства, доступные для каждой полилинии в 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 для Polyline .

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

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

Пример

// TrafficStyle is part of the Consumer SDK.
TrafficStyle trafficStyle = TrafficStyle.builder()
  .setTrafficVisibility(true)
  .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
  .setTrafficColor(SpeedType.NORMAL_VALUE, Color.BLUE)
  .setTrafficColor(SpeedType.SLOW_VALUE, Color.ORANGE)
  .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
  .build();

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle);

// TrafficStyle is part of the Consumer SDK.
val trafficStyle =
  TrafficStyle.builder()
    .setTrafficVisibility(true)
    .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
    .setTrafficColor(SpeedType.NORMAL_VALUE, Color.BLUE)
    .setTrafficColor(SpeedType.SLOW_VALUE, Color.ORANGE)
    .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
    .build()

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle)