Dostosuj linie łamane trasy

Wybierz platformę: Android iOS JavaScript

Do dostosowywania linii łamanych tras służy metoda 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 parametrem null dla parametru PolylineOptions.

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

Więcej informacji znajdziesz w 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 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ć 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ć wrażenia użytkownika, używając linii łamanych 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 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. Uwzględnia przesunięcie w zależności od warunków na drodze. 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ć linie łamane uwzględniające natężenie ruchu, utwórz obiekt TrafficStyle i 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)