Puoi personalizzare le polilinee del percorso utilizzando
ConsumerMapStyle.setPolylineStyleOptions
. Se imposti una polilinea personalizzata
sostituiscono i valori predefiniti forniti dall'SDK consumer.
Per ripristinare i valori predefiniti, richiama
setPolylineStyleOptions
:
con null
per il parametro PolylineOptions
.
Per recuperare PolylineOptions
attivo, usa
getPolylineStyleOptions
.
Per ulteriori informazioni, vedi
ConsumerMapStyle.setPolylineStyleOptions
Tipi di polilinee di route
Puoi personalizzare i seguenti tipi di polilinee di route:
ACTIVE_ROUTE
REMAINING_ROUTE
ACTIVE_ROUTE
e REMAINING_ROUTE
vengono visualizzati durante la condivisione del percorso e
rappresentano il percorso del veicolo.
Proprietà della polilinea di percorso
Google Maps fornisce proprietà personalizzabili disponibili per ogni polilinea in
PolylineOptions
.
Per creare
PolylineOptions
, utilizza il relativo costruttore.Per specificare proprietà personalizzate, utilizza "Impostatore" di stile. Dal giorno il metodo fornisce valori predefiniti per ogni proprietà, devi solo per specificare valori personalizzati.
Per disattivare la polilinea, imposta
visible
sufalse
.
Per ulteriori dettagli, vedi
PolylineOptions
nella documentazione per gli sviluppatori Android.
Esempio
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)
Percorso attivo e rimanente
Con la condivisione del percorso attivata, la tua app può personalizzare l'esperienza dell'utente utilizzando le polilinee per mostrare lo stato attivo e per il tuo veicolo.
Il percorso attivo è il percorso che il veicolo sta ora per raggiungere. la tappa successiva nella corsa attiva del consumatore.
Il percorso rimanente è il percorso che deve ancora percorrere il veicolo. la route attiva. Quando la tappa attiva è l'ultima tappa del percorso, la route rimanente non esiste.
Puoi personalizzare e controllare la visibilità delle polilinee attive e rimanenti in la tua app. Per impostazione predefinita, il percorso attivo è visibile, mentre quello rimanente non è visibile.
Esempio
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)
Polilinee sensibili al traffico
Il livello di traffico della polilinea è disattivato per impostazione predefinita. Quando lo abiliti, il renderer disegna segmenti sopra la polilinea di route che rappresentano tratti di e non normale. Include un offset che dipende dalle condizioni del traffico. Per ulteriori informazioni, consulta la documentazione per gli sviluppatori Android su Polyline.
Google Maps rappresenta le condizioni del traffico come quattro tipi di velocità. Puoi personalizzare il colore per ogni tipo di velocità.
Per attivare le polilinee sensibili al traffico, crea un oggetto TrafficStyle
e poi passalo a ConsumerMapStyle
chiamando setPolylineTrafficStyle()
.
Esempio
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)