Dostosuj linie łamane trasy

Wybierz platformę: Android iOS JavaScript

Wielolinie tras dostosowujesz za pomocą metody ConsumerMapStyle.setPolylineStyleOptions. Jeśli ustawisz niestandardowe opcje polilinii, zastąpią one wartości domyślne podane przez pakiet Consumer SDK.

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

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

Więcej informacji znajdziesz w sekcji ConsumerMapStyle.setPolylineStyleOptions.

Typy linii łamanych trasy

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

• ACTIVE_ROUTE
• REMAINING_ROUTE

Podczas śledzenia podróży wyświetlane są ikony ACTIVE_ROUTE i REMAINING_ROUTE, które reprezentują trasę pojazdu.

Właściwości linii łamanej trasy

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

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

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

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

Więcej informacji znajdziesz w PolylineOptions w dokumentacji dla deweloperów 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

Gdy udostępnianie trasy jest włączone, aplikacja może dostosowywać wrażenia użytkownika, używając polilinii do wyświetlania aktywnej i pozostałej trasy pojazdu.

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

• Pozostała trasa to droga, którą pojazd musi jeszcze pokonać po zakończeniu aktywnej trasy. Gdy aktywny punkt trasy jest ostatnim punktem trasy podróży, pozostała część trasy nie istnieje.

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

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 ruch

Warstwa ruchu na polilinii jest domyślnie wyłączona. Po włączeniu tej funkcji moduł renderujący rysuje segmenty nad linią łamaną trasy, które reprezentują odcinki o nietypowym natężeniu ruchu. Obejmuje on przesunięcie w zależności od warunków drogowych. Więcej informacji znajdziesz w dokumentacji dla deweloperów Androida na temat linii łamanej.

Mapy Google przedstawiają warunki na drodze w postaci jednego z 4 rodzajów prędkości. Możesz dostosować kolor każdego typu prędkości.

Aby włączyć polilinie uwzględniające ruch, 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)