Dostosuj linie łamane trasy

Wybierz platformę: Android iOS JavaScript

Do dostosowywania linii łamanych trasy służy Metoda ConsumerMapStyle.setPolylineStyleOptions. Jeśli ustawisz niestandardową linię łamaną , zastępują one wartości domyślne podane przez pakiet SDK dla klientów indywidualnych.

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: ConsumerMapStyle.setPolylineStyleOptions.

Typy linii łamanych trasy

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

  • ACTIVE_ROUTE
  • REMAINING_ROUTE

ACTIVE_ROUTE i REMAINING_ROUTE są wyświetlane podczas udostępniania podróży oraz reprezentują trasę pojazdu.

Właściwości linii łamanej trasy

Dla każdej linii łamanej w Mapach Google dostępne są niestandardowe właściwości PolylineOptions

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

  • Aby określić właściwości niestandardowe, użyj opcji „Setter”. stylu. Od podano domyślne wartości dla każdej usługi, potrzebujesz tylko , aby określić dowolne wartości niestandardowe.

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

Więcej informacji: PolylineOptions.

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 aplikacja może dostosować korzystanie z linii łamanych do pokazywania aktywnych i pozostałych trasy Twojego pojazdu.

  • Aktywna trasa to ścieżka, do której aktualnie przechodzi pojazd. kolejny punkt na trasie aktywnej podróży 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 do aplikacji. Domyślnie widoczna jest aktywna trasa, a pozostała trasa nie jest widoczny.

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 z uwzględnieniem natężenia ruchu

Warstwa ruchu ścieżki złożonej jest domyślnie wyłączona. Gdy włączysz tę funkcję, mechanizm renderowania rysuje nad linią łamaną trasy fragmenty, które reprezentują fragmenty przy normalnym ruchu. Zawiera przesunięcie zależne od warunków na drodze. Więcej informacji znajdziesz w dokumentacji pakietu Polyline dla deweloperów aplikacji na Androida.

Mapy Google przedstawiają warunki na drodze jako jedną z czterech rodzajów prędkości. Możesz dostosować kolor do każdego rodzaju szybkości.

Aby włączyć linie łamane uwzględniające ruch, utwórz obiekt TrafficStyle a następnie przekazać ją ConsumerMapStyle, dzwoniąc pod numer 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)