Personalizza gli indicatori

Seleziona la piattaforma: Android iOS JavaScript

La ConsumerMapStyle classe fornisce metodi setter e getter con personalizzazione dinamica per indicatori e polilinee. Questa classe viene esposta in modo asincrono utilizzando il ConsumerController.getConsumerMapStyle() metodo.

La personalizzazione dell'interfaccia utente persiste durante le rotazioni del dispositivo e rimane in vigore finché non scolleghi ConsumerController.

Personalizzare gli indicatori

Per impostare il tipo di indicatore e le relative proprietà, utilizza il ConsumerMapStyle.setMarkerStyleOptions() metodo. Le opzioni degli indicatori personalizzati sostituiscono i valori predefiniti forniti da Consumer SDK. Per ripristinare i valori predefiniti, chiama setMarkerStyleOptions() utilizzando null per il parametro MarkerOptions. Recupera attivo MarkerOptions utilizzando getMarkerStyleOptions().

Selezionare un tipo di indicatore

Puoi utilizzare e personalizzare le seguenti icone degli indicatori:

  • TRIP_PICKUP_POINT - Viene visualizzato durante il monitoraggio di un viaggio
  • TRIP_DROPOFF_POINT - Viene visualizzato durante il monitoraggio di un viaggio
  • TRIP_INTERMEDIATE_DESTINATION

  • TRIP_VEHICLE - Viene visualizzato durante il monitoraggio di un viaggio

    Consumer SDK aggiorna la rotazione dell'icona TRIP_VEHICLE durante il monitoraggio del viaggio per imitare il comportamento del veicolo reale mentre percorre il percorso.

Selezionare le opzioni degli indicatori

Per personalizzare gli indicatori per l'app per utenti finali:

  1. Utilizza le proprietà di ogni indicatore fornite da MarkerOptions di Google Maps.

  2. Crea MarkerOptions utilizzando il relativo costruttore.

  3. Specifica le proprietà personalizzate utilizzando i metodi di stile "Setter".

  4. Se preferisci, utilizza il tuo elemento dell'interfaccia utente imitando i pattern forniti dal costruttore MarkerOptions.

  5. Per disattivare un indicatore, imposta la proprietà visible su false. Puoi quindi utilizzare il tuo elemento dell'interfaccia utente al suo posto.

Per ulteriori informazioni, consulta Google Maps MarkerOptions.

Esempi di personalizzazioni degli indicatori

Java

// Initializing marker options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setMarkerStyleOptions(
              MarkerType.TRIP_VEHICLE,
              new MarkerOptions()
                  .visible(false));
        });

// Reset marker options to default values.
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, null);

Kotlin

// Initializing marker options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, MarkerOptions().visible(false))
  })

// Reset marker options to default values.
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, null)

Passaggi successivi