Dostosuj linie łamane trasy

Dostosowanie linii ścieżki docelowej za pomocą metody ConsumerMapStyle.setPolylineStyleOptions. Jeśli ustawisz niestandardowe opcje ścieżki wielopunktowej, zastąpią one wartości domyślne udostępniane przez pakiet Consumer SDK.

Aby przywrócić wartości domyślne, wywołaj funkcję setPolylineStyleOptions, podając parametr null zamiast parametru PolylineOptions.

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

Więcej informacji znajdziesz w sekcji ConsumerMapStyle.setPolylineStyleOptions.

Typy linii złożonych tras

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ć obiekt PolylineOptions, użyj jego konstruktora.

• Aby określić właściwości niestandardowe, użyj metod typu „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ć polilinię, ustaw wartość visible na false.

Więcej informacji znajdziesz w PolylineOptions w dokumentacji dla deweloperów Androida.

Przykład

// 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);

// 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 dostosować wyświetlanie danych dla użytkownika za pomocą linii wielokątnych, aby pokazać aktywną i pozostałą trasę pojazdu.

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

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

Możesz dostosowywać i sterować widocznością aktywnej i pozostałościowej ścieżki w swojej aplikacji. Domyślnie aktywna trasa jest widoczna, a pozostałościowa – nie.

Przykład

// 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);

// 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

Warstw ruchu w wielokącie nie można domyślnie wyłączyć. Po włączeniu tej opcji renderowanie rysuje segmenty nad polilinią trasy, które reprezentują odcinki nietypowego ruchu. Obejmuje ona przesunięcie w zależności od warunków na drodze. Więcej informacji znajdziesz w dokumentacji dla deweloperów Androida dotyczącej Polyline.

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ć ścieżki uwzględniające natężenie ruchu, utwórz obiekt TrafficStyle, a potem przekaż go do ConsumerMapStyle, wywołując funkcję setPolylineTrafficStyle().

Przykład

// 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);

// 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)