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)