Karte gestalten

In diesem Dokument wird beschrieben, wie Sie das Design einer Karte anpassen und die Datensichtbarkeit und Darstellungsoptionen steuern. Dazu haben Sie folgende Möglichkeiten:

• Cloudbasiertes Gestalten von Karteninhalten verwenden
• Kartenstiloptionen direkt im eigenen Code festlegen

Karte mit cloudbasiertem Gestalten von Karteninhalten anpassen

Wenn Sie einen Kartenstil auf Ihre JavaScript-Karte für die Fahrtenfreigabe für Verbraucher anwenden möchten, geben Sie beim Erstellen von JourneySharingMapView eine mapId und alle anderen mapOptions an.

In den folgenden Beispielen wird gezeigt, wie ein Kartenstil mit einer Karten-ID angewendet wird.

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.
});

Karten mit benutzerdefinierten Stilen direkt im eigenen Code gestalten

Sie können den Kartenstil auch anpassen, indem Sie beim Erstellen des JourneySharingMapView-Objekts Kartenoptionen festlegen. In den folgenden Beispielen wird gezeigt, wie Sie eine Karte mithilfe von Kartenoptionen gestalten. Weitere Informationen zu den Kartenoptionen, die Sie festlegen können, finden Sie in der Referenz zur Google Maps JavaScript API unter mapOptions.

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" }
        ]
      }
    ]
  }
});

Sichtbarkeit von Aufgabendaten für das SDK steuern

Sie können die Sichtbarkeit bestimmter Aufgabenobjekte auf der Karte mithilfe von Sichtbarkeitsregeln steuern.

Standardsichtbarkeit von Aufgabendaten

Standardmäßig sind Daten für Aufgaben, die einem Fahrzeug zugewiesen sind, sichtbar, wenn das Fahrzeug maximal fünf Stopps von der Aufgabe entfernt ist. Die Sichtbarkeit endet, wenn die Aufgabe abgeschlossen oder abgebrochen wird.

In dieser Tabelle sehen Sie die Standardsichtbarkeit für die einzelnen Aufgabentypen. Sie können die Sichtbarkeit für viele, aber nicht alle Aufgaben anpassen. Weitere Informationen zu Aufgabentypen finden Sie unter Aufgabentypen im Leitfaden Geplante Aufgaben.

Sichtbarkeit offener Fahrzeugaufgaben anpassen

Die Schnittstelle TaskTrackingInfo bietet eine Reihe von Aufgabendatenelementen, die mit dem Consumer SDK sichtbar gemacht werden können.

Sichtbarkeitsoptionen pro Aufgabe

Sie können die Sichtbarkeitskonfiguration für jede Aufgabe einzeln anpassen, indem Sie beim Erstellen oder Aktualisieren einer Aufgabe in Fleet Engine TaskTrackingViewConfig festlegen. Verwenden Sie die folgenden Sichtbarkeitsoptionen, um Kriterien für die Sichtbarkeit eines Aufgabenelements zu erstellen:

Angenommen, eine Beispielanpassung ändert die Sichtbarkeit für drei Datenelemente anhand der Kriterien in der folgenden Tabelle. Für alle anderen Elemente gelten die Standardsichtbarkeitsregeln.

Das folgende Beispiel zeigt diese Konfiguration:

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

Regeln für die Sichtbarkeit von Routen-Polylinien und Fahrzeugstandorten

Routen-Polylinien können nur sichtbar sein, wenn auch der Fahrzeugstandort sichtbar ist. Andernfalls kann der Fahrzeugstandort am Ende einer Polylinie abgeleitet werden.

Anhand dieser Richtlinien können Sie eine gültige Kombination für die Sichtbarkeitsoptionen für die Routen-Polylinie und den Fahrzeugstandort angeben.

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

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

Automatische Anpassung deaktivieren

Sie können verhindern, dass die Karte den Darstellungsbereich automatisch an das Fahrzeug und die voraussichtliche Route anpasst, indem Sie die automatische Anpassung deaktivieren. Im folgenden Beispiel wird gezeigt, wie Sie die automatische Anpassung deaktivieren, wenn Sie die Kartenansicht für die Fahrtenfreigabe konfigurieren.

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,
  ...
});

Nächste Schritte

• Markierungen anpassen
• Polylinien anpassen