Definizione di una mappa

Questo documento spiega come personalizzare l'aspetto di una mappa e controllare la visibilità dei dati e le opzioni del riquadro. Puoi farlo nei seguenti modi:

• Utilizzare la personalizzazione delle mappe basata su cloud
• Impostare le opzioni di stile di mappa direttamente nel tuo codice

Personalizzare lo stile della mappa con la personalizzazione delle mappe basata su cloud

Per applicare uno stile di mappa alla mappa di condivisione del viaggio del consumatore JavaScript, specifica un mapId e qualsiasi altro mapOptions quando crei JourneySharingMapView.

Gli esempi seguenti mostrano come applicare uno stile di mappa con un ID mappa.

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

Personalizzare lo stile delle mappe direttamente nel tuo codice

Puoi anche personalizzare lo stile della mappa impostando le opzioni della mappa quando crei JourneySharingMapView. Gli esempi seguenti mostrano come personalizzare lo stile di una mappa utilizzando le opzioni della mappa. Per ulteriori informazioni sulle opzioni della mappa che puoi impostare, consulta mapOptions nel riferimento dell'API Maps JavaScript.

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

Controllare la visibilità dei dati delle attività per l'SDK

Puoi controllare la visibilità di determinati oggetti attività sulla mappa utilizzando le regole di visibilità.

Visibilità predefinita dei dati delle attività

Per impostazione predefinita, i dati delle attività assegnate a un veicolo sono visibili quando il veicolo si trova a un massimo di 5 fermate dall'attività. La visibilità termina quando l'attività viene completata o annullata.

Questa tabella mostra la visibilità predefinita per ogni tipo di attività. Puoi personalizzare la visibilità di molte attività, ma non di tutte. Per maggiori dettagli sui tipi di attività, consulta Tipi di attività nella guida Attività pianificate.

Personalizzare la visibilità delle attività del veicolo aperte

L'interfaccia TaskTrackingInfo fornisce una serie di elementi di dati delle attività che possono essere resi visibili con l'SDK Consumer.

Opzioni di visibilità per attività

Puoi personalizzare la configurazione della visibilità per ogni attività impostando il TaskTrackingViewConfig quando crei o aggiorni un'attività in Fleet Engine. Utilizza le seguenti opzioni di visibilità per creare criteri per determinare la visibilità di un elemento di un'attività:

Per illustrare, supponiamo che una personalizzazione di esempio regoli la visibilità di tre elementi di dati utilizzando i criteri mostrati nella tabella seguente. Tutti gli altri elementi seguono le regole di visibilità predefinite.

L'esempio seguente mostra questa configurazione:

"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "estimatedArrivalTimeVisibility": {
    "remainingDrivingDistanceMetersThreshold": 5000
  },
  "remainingStopCountVisibility": {
    "never": true
  }
}

Regole di visibilità per le polilinee del percorso e la posizione del veicolo

Le polilinee del percorso non possono essere visibili a meno che non sia visibile anche la posizione del veicolo; in caso contrario, la posizione del veicolo può essere dedotta dalla fine di una polilinea.

Queste linee guida ti aiutano a fornire una combinazione valida per le opzioni di visibilità delle polilinee del percorso e della posizione del veicolo.

    "taskTrackingViewConfig": {
      "routePolylinePointsVisibility": {
        "remainingStopCountThreshold": 3
      },
      "vehicleLocationVisibility": {
        "remainingStopCountThreshold": 5
      },
    }
    

  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "vehicleLocationVisibility": {
      "remainingDrivingDistanceMetersThreshold": 3000
    },
  }

Disattivare l'adattamento automatico

Puoi impedire alla mappa di adattare automaticamente il riquadro al veicolo e al percorso previsto disattivando l'adattamento automatico. L'esempio seguente mostra come disattivare l'adattamento automatico quando configuri la visualizzazione della mappa di condivisione del viaggio.

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

Passaggi successivi

• Personalizzare gli indicatori
• Personalizzare le polilinee