Dostosuj linie łamane trasy

Wybierz platformę: Android iOS JavaScript

Linie łamane trasy dostosowujesz za pomocą metody 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 wartością null dla parametru PolylineOptions.

Aby pobrać aktywne PolylineOptions, użyj getPolylineStyleOptions metody.

Więcej informacji znajdziesz w artykule 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 podróży i reprezentują trasę pojazdu.

Właściwości linii łamanej trasy

Mapy Google udostępniają konfigurowalne właściwości dostępne 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ż metoda udostępnia wartości domyślne dla każdej właściwości, musisz tylko określić wartości niestandardowe.

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

Więcej informacji znajdziesz w dokumentacji dla deweloperów Androida w artykule 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

Gdy udostępnianie podróży jest włączone, Twoja aplikacja może dostosowywać wrażenia użytkownika za pomocą linii łamanych, aby pokazywać aktywną i pozostałą trasę pojazdu.

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

• Pozostała trasa to ścieżka, którą pojazd musi jeszcze pokonać po aktywnej trasie. Gdy punkt na aktywnej trasie jest ostatnim punktem na trasie, pozostała trasa nie istnieje.

Możesz dostosować i kontrolować widoczność aktywnych i pozostałych linii łamanych w swojej aplikacji. Domyślnie aktywna trasa jest widoczna, a pozostała trasa nie jest widoczna.

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 natężenia ruchu linii łamanej jest domyślnie wyłączona. Gdy ją włączysz, moduł renderujący narysuje segmenty nad linią łamaną trasy, które reprezentują odcinki o nietypowym natężeniu ruchu. Zawiera ona przesunięcie zależne od warunków drogowych. Więcej informacji znajdziesz w dokumentacji dla deweloperów Androida w artykule Polyline.

Mapy Google przedstawiają warunki na drodze jako jeden z 4 typów prędkości. Możesz dostosować kolor każdego typu prędkości.

Aby włączyć linie łamane uwzględniające natężenie ruchu, 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)