Personalizza gli indicatori

Seleziona la piattaforma: Android iOS JavaScript

Personalizza l'aspetto degli indicatori aggiunti alla mappa. Personalizza il look gli indicatori sono stati aggiunti alla mappa in due modi:

  1. Indicatori di stile in base al tipo: specifica un MarkerOptions: per applicare uno stile agli indicatori dello stesso tipo. Le modifiche specificate sono applicati dopo la creazione di ciascun indicatore, sovrascrivendo eventuali opzioni predefinite. Per alcuni esempi, consulta la sezione Modificare lo stile degli indicatori utilizzando MarkerOptions in questa guida.

  2. Personalizza gli indicatori in base ai dati: specifica una funzione di personalizzazione per personalizzare gli indicatori in base ai dati. Puoi definire lo stile in base ai dati del percorso condivisibili o da fonti esterne:

    • Dati provenienti dalla condivisione del percorso: i dati degli indicatori delle tessere per la condivisione del percorso vengono inviati alla funzione di personalizzazione che comprende il tipo di oggetto rappresentato dall'indicatore: veicolo, luogo di partenza, tappa o destinazione. Stile dell'indicatore e poi modifiche in base allo stato corrente dell'elemento indicatore. Ad esempio, il numero di tappe rimanenti fino al termine della corsa del veicolo.

    • Fonti esterne: puoi combinare i dati di condivisione relativi al percorso con da origini esterne a Fleet Engine e definire lo stile dell'indicatore in base a informazioni.

    Per alcuni esempi, vedi Modificare lo stile degli indicatori utilizzando le funzioni di personalizzazione in questa guida.

  3. Aggiungere la gestione dei clic agli indicatori: ad esempio, consulta Aggiungere gestione dei clic.

Opzioni di personalizzazione dell'indicatore

Entrambe le opzioni utilizzano i seguenti parametri di personalizzazione nel API Maps JavaScript in FleetEngineTripLocationProviderOptions:

Modifica lo stile degli indicatori utilizzando MarkerOptions

L'esempio seguente mostra come configurare lo stile degli indicatori di veicoli con è un oggetto MarkerOptions. Segui questo schema per personalizzare lo stile di utilizzando una delle personalizzazioni degli indicatori elencate Opzioni di personalizzazione dell'indicatore.

JavaScript

deliveryVehicleMarkerCustomization = {
  cursor: 'grab'
};

TypeScript

deliveryVehicleMarkerCustomization = {
  cursor: 'grab'
};

Modificare lo stile degli indicatori utilizzando le funzioni di personalizzazione

L'esempio seguente mostra come configurare lo stile degli indicatori di veicoli utilizzando funzioni di personalizzazione. Segui questo schema per personalizzare lo stile di utilizzando uno dei parametri di personalizzazione degli indicatori elencati in Opzioni di personalizzazione dell'indicatore.

JavaScript

vehicleMarkerCustomization =
  (params) => {
    var distance = params.trip.remainingWaypoints.length;
    params.marker.setLabel(`${distance}`);
  };

TypeScript

vehicleMarkerCustomization =
  (params: TripMarkerCustomizationFunctionParams) => {
    const distance = params.trip.remainingWaypoints.length;
    params.marker.setLabel(`${distance}`);
};

Aggiungi gestione dei clic agli indicatori

L'esempio seguente mostra come aggiungere la gestione dei clic a un indicatore di veicolo. Segui questo schema per aggiungere la gestione dei clic a qualsiasi indicatore utilizzando uno degli indicatori elencati in Opzioni di personalizzazione dell'indicatore.

JavaScript

vehicleMarkerCustomization =
  (params) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

TypeScript

vehicleMarkerCustomization =
  (params: TripMarkerCustomizationFunctionParams) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

Passaggi successivi