Dostosuj linie łamane trasy

Wybierz platformę: Android iOS JavaScript

Do dostosowywania linii łamanych trasy służy metoda ConsumerMapStyle.setPolylineStyleOptions. Jeśli ustawisz niestandardowe opcje ścieżki wielopunktowej, zastąpią one wartości domyślne udostępnione przez pakiet Consumer SDK.

Aby przywrócić wartości domyślne, wywołaj funkcję setPolylineStyleOptions i ustaw null w przypadku parametru PolylineOptions.

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

Więcej informacji: ConsumerMapStyle.setPolylineStyleOptions.

Typy linii łamanych trasy

Możesz dostosować te typy ścieżek:

• 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ą właściwości dostosowane do potrzeb użytkownika, które są dostępne dla każdej polilinii w PolylineOptions.

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

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

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

Więcej informacji znajdziesz w sekcji 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 podróży Twoja aplikacja może dostosować sposób korzystania z linii łamanych do użytkownika, aby wyświetlać aktywną i pozostałą trasę dla Twojego pojazdu.

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

• Pozostała trasa to droga, którą pojazd musi jeszcze przebyć po zakończeniu aktywnej trasy. Gdy aktywny punkt pośredni na trasie jest ostatnim punktem na trasie podróży, 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 reszta – niewidoczna.

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 linii łamanej jest domyślnie wyłączona. Po jej włączeniu mechanizm renderowania rysuje nad linią łamaną trasy segmenty, które reprezentują fragmenty nietypowego ruchu. Obejmuje ona przesunięcie w zależności od warunków na drodze. Więcej informacji znajdziesz w dokumentacji pakietu Polyline dla deweloperów aplikacji na Androida.

Mapy Google przedstawiają warunki drogowe za pomocą 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 ruch, utwórz obiekt TrafficStyle, a następnie przekaż go do ConsumerMapStyle, wywołując funkcję setPolylineTrafficStyle().

Przykład

Java

// TrafficStyle is part of the Consumer SDK.
TrafficStyle trafficStyle = TrafficStyle.builder()
  .setTrafficVisibility(true)
  .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
  .setTrafficColor(SpeedType.NORMAL_VALUE, Color.BLUE)
  .setTrafficColor(SpeedType.SLOW_VALUE, Color.ORANGE)
  .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
  .build();

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle);

Kotlin

// TrafficStyle is part of the Consumer SDK.
val trafficStyle =
  TrafficStyle.builder()
    .setTrafficVisibility(true)
    .setTrafficColor(SpeedType.NO_DATA, Color.GREY)
    .setTrafficColor(SpeedType.NORMAL_VALUE, Color.BLUE)
    .setTrafficColor(SpeedType.SLOW_VALUE, Color.ORANGE)
    .setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
    .build()

consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle)