Dostosuj linie łamane trasy

Wybierz platformę: Android iOS JavaScript

Łamane trasy możesz dostosowywać za pomocą metody ConsumerMapStyle.setPolylineStyleOptions. Jeśli ustawisz niestandardowe opcje linii łamanej, zastąpią one wartości domyślne podane przez pakiet SDK dla konsumentów.

Aby przywrócić wartości domyślne, wywołaj setPolylineStyleOptions z wartością null parametru PolylineOptions.

Aby pobrać aktywny PolylineOptions, użyj metody getPolylineStyleOptions.

Więcej informacji: ConsumerMapStyle.setPolylineStyleOptions.

Typy linii łamanych trasy

Możesz dostosować te typy linii łamanych trasy:

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

Podczas śledzenia przejazdu wyświetlane są parametry ACTIVE_ROUTE i REMAINING_ROUTE, które reprezentują trasę pojazdu.

Właściwości linii łamanej trasy

Mapy Google udostępniają dostosowywane właściwości dla każdej linii łamanej w PolylineOptions.

  • Aby utworzyć obiekt PolylineOptions, użyj jego konstruktora.

  • Aby określić właściwości niestandardowe, użyj metod w stylu „Setter”. Metoda udostępnia domyślne wartości każdej właściwości, więc musisz określić tylko wartości niestandardowe.

  • Aby wyłączyć polilinię, ustaw visible na false.

Więcej informacji znajdziesz w artykule PolylineOptions w dokumentacji dla deweloperów aplikacji na Androida.

Przykład

Java

// 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);

Kotlin

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

Aktywna i pozostała trasa

Po włączeniu udostępniania przejazdu aplikacja może dostosowywać sposób korzystania z usługi przez użytkownika, wyświetlając za pomocą linii łamanych aktywną i pozostałą trasę pojazdu.

  • Aktywna trasa to ścieżka, którą pojazd jedzie, aby dotrzeć do następnego punktu na aktywnej trasie klienta.

  • Pozostała trasa to ścieżka, którą pojazd musi jeszcze pokonać po aktywnej trasie. Gdy punkt na trasie aktywnej trasy jest ostatnim punktem na trasie przejazdu, pozostała trasa nie istnieje.

Możesz dostosować i kontrolować widoczność aktywnych i pozostałych linii łamanych w aplikacji. Domyślnie aktywna trasa jest widoczna, a pozostała trasa nie jest widoczna.

Przykład

Java

// 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);

Kotlin

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

Linie łamane uwzględniające natężenie ruchu

Warstwa natężenia ruchu polilinii jest domyślnie wyłączona. Gdy ją włączysz, moduł renderujący narysuje nad linią łamaną trasy segmenty, które reprezentują odcinki o nietypowym natężeniu ruchu. Obejmuje przesunięcie w zależności od warunków na drodze. Więcej informacji znajdziesz w dokumentacji dla deweloperów aplikacji na Androida dotyczącej polilinii.

Mapy Google przedstawiają warunki na drodze jako jeden z 4 typów prędkości. Możesz dostosować kolor dla każdego typu prędkości.

Aby włączyć linie łamane uwzględniające natężenie ruchu, utwórz obiekt TrafficStyle, a następnie przekaż go do ConsumerMapStyle, wywołując setPolylineTrafficStyle().

Przykład

Java

// 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);

Kotlin

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