Personalizza gli indicatori

Seleziona la piattaforma: Android iOS JavaScript

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

La personalizzazione dell'interfaccia utente viene mantenuta durante le rotazioni del dispositivo e rimane in vigore finché non stacchi la ConsumerController.

Personalizzare i marcatori

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

Seleziona un tipo di indicatore

Puoi utilizzare e personalizzare le seguenti icone dei segnaposto:

• 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

  L'SDK per i consumatori aggiorna la rotazione dell'icona TRIP_VEHICLE durante il monitoraggio del viaggio per imitare il comportamento del veicolo reale mentre percorre l'itinerario.

Nota: per ottenere risultati di animazione più realistici, utilizza una prospettiva dall'alto per TRIP_VEHICLE, con la parte anteriore del veicolo orientata verso l'alto.

Nota: l'icona dell'indicatore non cambia in base al tipo di veicolo effettivo per il viaggio.

Seleziona le opzioni per gli indicatori

Puoi personalizzare gli indicatori per la tua app per utenti finali seguendo questi passaggi:

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

2. Crea MarkerOptions utilizzando il relativo costruttore.

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

   Nota: poiché l'SDK fornisce valori predefiniti per ogni proprietà dell'indicatore, specifica solo le proprietà personalizzate per i valori che vuoi modificare.

4. Se preferisci, utilizza il tuo elemento UI imitando i pattern forniti dal costruttore MarkerOptions.

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

Per ulteriori informazioni, consulta la pagina di 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

• Personalizzare le polilinee del percorso