Sie können Routenpolylinien mit der Methode ConsumerMapStyle.setPolylineStyleOptions
anpassen. Wenn Sie benutzerdefinierte Polylinienoptionen festlegen, werden die Standardwerte des Consumer SDK überschrieben.
Zum Wiederherstellen der Standardwerte rufen Sie setPolylineStyleOptions
mit null
für den Parameter PolylineOptions
auf.
Zum Abrufen des aktiven PolylineOptions
verwenden Sie die Methode getPolylineStyleOptions
.
Weitere Informationen finden Sie unter ConsumerMapStyle.setPolylineStyleOptions
.
Polylinientypen für Routen
Sie können die folgenden Polylinientypen für Routen anpassen:
ACTIVE_ROUTE
REMAINING_ROUTE
ACTIVE_ROUTE
und REMAINING_ROUTE
werden angezeigt, während Sie einer Fahrt folgen, und stellen die Route des Fahrzeugs dar.
Eigenschaften von Routenpolylinien
Google Maps bietet für jede Polylinie in PolylineOptions
anpassbare Eigenschaften.
Verwenden Sie den Konstruktor, um
PolylineOptions
zu erstellen.Um benutzerdefinierte Eigenschaften anzugeben, verwenden Sie Setter-Stilmethoden. Da die Methode Standardwerte für jede Property bereitstellt, müssen Sie nur benutzerdefinierte Werte angeben.
Wenn Sie die Polylinie deaktivieren möchten, setzen Sie
visible
auffalse
.
Weitere Informationen findest du in der Android-Entwicklerdokumentation unter PolylineOptions
.
Beispiel
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)
Aktive und verbleibende Route
Wenn die Freigabe von Fahrten aktiviert ist, kann Ihre App die Nutzung für Nutzer mithilfe von Polylinien anpassen, um die aktive und verbleibende Route für Ihr Fahrzeug anzuzeigen.
Der aktive Weg ist der Weg, den das Fahrzeug gerade zurücklegt, um den nächsten Wegpunkt der aktiven Fahrt des Nutzers zu erreichen.
Die verbleibende Route ist der Weg, den das Fahrzeug noch zurücklegen muss, nachdem es die aktive Route passiert hat. Wenn der Wegpunkt der aktiven Route der letzte Wegpunkt ist, existiert die verbleibende Route nicht.
Sie können die Sichtbarkeit aktiver und verbleibender Polylinien in Ihrer App anpassen und steuern. Standardmäßig ist nur die aktive Route sichtbar.
Beispiel
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)
Polylinien mit Verkehrserkennung
Die Verkehrsebene der Polylinie ist standardmäßig deaktiviert. Wenn Sie diese Option aktivieren, zeichnet der Renderer Segmente über der Routenpolylinie, die Abschnitte mit nicht normalem Verkehr darstellen. Sie enthält einen Versatz, der von der Verkehrslage abhängt. Weitere Informationen finden Sie in der Android-Entwicklerdokumentation zu Polylinie.
In Google-Karten wird die Verkehrslage als eine von vier Geschwindigkeitstypen dargestellt. Sie können die Farbe für jeden Geschwindigkeitstyp anpassen.
Wenn Sie verkehrsabhängige Polylinien aktivieren möchten, erstellen Sie ein TrafficStyle
-Objekt und übergeben Sie es dann an ConsumerMapStyle
, indem Sie setPolylineTrafficStyle()
aufrufen.
Beispiel
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)