Personalizza le polilinee del percorso

Seleziona la piattaforma: Android iOS JavaScript

Personalizzi i polilinei del percorso utilizzando il metodo 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 del percorso:

  • 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 su false.

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 il veicolo deve ancora percorrere oltre il percorso attivo. 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 del 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 uno dei 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)