Łamane trasy możesz dostosowywać 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 parametrem PolylineOptions ustawionym na null.
Aby pobrać aktywny PolylineOptions, użyj metody getPolylineStyleOptions.
Więcej informacji: ConsumerMapStyle.setPolylineStyleOptions.
Typy linii łamanych trasy
Możesz dostosować te typy linii łamanych trasy:
ACTIVE_ROUTEREMAINING_ROUTE
ACTIVE_ROUTE i REMAINING_ROUTE są wyświetlane podczas śledzenia przejazdu i reprezentują trasę pojazdu.
Właściwości linii łamanej trasy
Mapy Google udostępniają dostosowywane właściwości dla każdej linii łamanej w PolylineOptions.
Aby utworzyć obiekt
PolylineOptions, użyj jego konstruktora.Aby określić właściwości niestandardowe, użyj metod w stylu „Setter”. Metoda udostępnia domyślne wartości każdej właściwości, więc musisz określić tylko wartości niestandardowe.
Aby wyłączyć polilinię, ustaw
visiblenafalse.
Więcej informacji znajdziesz w artykule 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
Dzięki włączonemu udostępnianiu przejazdu 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 jedzie, aby dotrzeć do następnego punktu na trasie klienta.
Pozostała trasa to ścieżka, którą pojazd musi jeszcze pokonać po przejechaniu aktywnej trasy. Gdy aktywny punkt na trasie jest ostatnim punktem przejazdu, 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 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 polilinii jest domyślnie wyłączona. Gdy ją włączysz, moduł renderujący będzie rysować nad polilinią trasy segmenty, które reprezentują odcinki o nietypowym natężeniu ruchu. Obejmuje przesunięcie w zależności od warunków na drodze. Więcej informacji znajdziesz w dokumentacji dla deweloperów aplikacji na Androida dotyczącej polilinii.
Mapy Google przedstawiają warunki na drodze jako jeden z 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 natężenie ruchu, utwórz obiekt TrafficStyle i 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)