Dostosuj linie łamane trasy

Wybierz platformę: Android iOS JavaScript

Polilinie trasy możesz dostosowywać 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

ACTIVE_ROUTE i REMAINING_ROUTE są wyświetlane podczas śledzenia podróży i 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”. 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 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 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 konsumenta.

  • Pozostała trasa to odcinek, który pojazd musi jeszcze pokonać po minięciu aktywnej trasy. Gdy aktywny punkt trasy jest ostatnim punktem trasy podróży, pozostała część trasy nie istnieje.

Możesz dostosowywać widoczność aktywnych i pozostałych linii łamanych w aplikacji oraz nią zarządzać. 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ą 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 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)