Dostosuj linie łamane trasy

Wybierz platformę: Android iOS JavaScript

Wielolinie tras 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 Consumer SDK.

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

Aby pobrać aktywną PolylineOptions, użyj metody getPolylineStyleOptions.

Więcej informacji znajdziesz w sekcji ConsumerMapStyle.setPolylineStyleOptions.

Typy linii łamanych trasy

Możesz dostosować następujące typy linii łamanych trasy:

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

Podczas śledzenia podróży wyświetlane są ikony ACTIVE_ROUTE i REMAINING_ROUTE, które oznaczają 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”. Ponieważ ta metoda udostępnia wartości domyślne dla każdej właściwości, musisz tylko określić wartości niestandardowe.

  • Aby wyłączyć linię łamaną, 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ć usługi użytkownika za pomocą linii łamanych, aby pokazywać aktywną i pozostałą trasę pojazdu.

  • Aktywna trasa to ścieżka, którą pojazd pokonuje, 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 aktywny punkt na trasie jest ostatnim punktem na trasie przejazdu, 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 natężenie ruchu

Warstwa ruchu na polilinii jest domyślnie wyłączona. Gdy włączysz tę opcję, mechanizm renderowania będzie rysować segmenty nad linią łamaną trasy, które reprezentują odcinki o nietypowym natężeniu ruchu. Obejmuje on przesunięcie zależne 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 dla 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)