Fleet Tracking - On Demand Rides & Delivery (beta)

Klasse FleetEngineVehicleLocationProvider

google.maps.journeySharing.FleetEngineVehicleLocationProvider Kurs

Anbieter der Fahrzeugstandortermittlung.

Diese Klasse erweitert PollingLocationProvider.

Rufe const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
Parameter: 
Erstellt einen neuen Standortanbieter für ein Fleet Engine-Fahrzeug.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parameter: 
Rückgabewert:Keiner
Funktion zur Polylinienanpassung, mit der die aktive Polylinie entsprechend der Geschwindigkeitsmessung eingefärbt wird. Geben Sie diese Funktion als FleetEngineVehicleLocationProviderOptions.activePolylineCustomization an, um eine verkehrsabhängige Polylinie für die aktive Polylinie zu rendern.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parameter: 
Rückgabewert:Keiner
Funktion zur Polylinienanpassung, mit der die verbleibende Polylinie entsprechend der Geschwindigkeitsmessung eingefärbt wird. Geben Sie diese Funktion als FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization an, um eine verkehrsabhängige Polylinie für die verbleibende Polylinie zu rendern.
staleLocationThresholdMillis
Typ:number
Dieses Feld ist schreibgeschützt. Grenzwert für veralteten Fahrzeugstandort. Wenn der zuletzt aktualisierte Standort des Fahrzeugs älter als dieser Grenzwert ist, wird das Fahrzeug nicht angezeigt.
vehicleId
Typ:string
ID für das Fahrzeug, das von diesem Standortanbieter beobachtet wird. Legen Sie dieses Feld fest, um ein Fahrzeug zu verfolgen.
Übernommen:isPolling, pollingIntervalMillis
Übernommen:addListener
error
function(event)
Argumente: 
Ereignis, das ausgelöst wird, wenn beim Standortanbieter ein Fehler auftritt.
update
function(event)
Ereignis, das ausgelöst wird, wenn eine Anfrage zur Aktualisierung von Fleet Engine-Daten abgeschlossen ist.
Übernommen:ispollingchange

FleetEngineVehicleLocationProviderOptions-Schnittstelle

google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions Benutzeroberfläche

Optionen für den Anbieter der Fahrzeugstandortermittlung.

authTokenFetcher
Stellt JSON Web Tokens für die Authentifizierung des Clients bei der Fleet Engine bereit.
projectId
Typ:string
Die Projekt-ID des Verbrauchers aus der Google Cloud Console.
activePolylineCustomization optional
Anpassung, die auf die aktive Polylinie angewendet wird. Eine aktive Polylinie entspricht einem Teil der Route, den das Fahrzeug gerade befährt.

In diesem Feld können Sie benutzerdefiniertes Styling (z. B. Polylinienfarbe) und Interaktivität (z. B. Klickbehandlung) angeben.
  • Wenn ein PolylineOptions-Objekt angegeben ist, werden die darin angegebenen Änderungen nach dem Erstellen der Polylinie auf die Polylinie angewendet. Die Standardoptionen werden dabei überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie beim Erstellen der Polylinie einmal aufgerufen. Bei dieser Aufrufung wird der Parameter isNew im Objekt „function parameters“ auf true gesetzt. Außerdem wird diese Funktion aufgerufen, wenn sich die Koordinaten der Polylinie ändern oder der Standortanbieter Daten von der Fleet Engine empfängt, unabhängig davon, ob sich die Daten für diese Polylinie geändert haben.

    Eine Liste der bereitgestellten Parameter und ihrer Verwendung finden Sie unter VehiclePolylineCustomizationFunctionParams.
destinationMarkerCustomization optional
Anpassung, die auf die Zielmarkierung der Fahrzeugfahrt angewendet wird.

In diesem Feld können Sie benutzerdefiniertes Styling (z. B. ein Markierungssymbol) und Interaktivität (z. B. Klickbehandlung) angeben.
  • Wenn ein MarkerOptions-Objekt angegeben ist, werden die darin angegebenen Änderungen nach dem Erstellen der Markierung auf die Markierung angewendet. Die Standardoptionen werden dabei überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie einmal beim Erstellen der Markierung aufgerufen, bevor sie der Kartenansicht hinzugefügt wird. Bei dieser Aufrufung wird der Parameter isNew im Objekt „function parameters“ auf true festgelegt. Außerdem wird diese Funktion aufgerufen, wenn der Standortanbieter Daten von der Fleet Engine empfängt, unabhängig davon, ob sich die Daten für diese Markierung geändert haben.

    Eine Liste der bereitgestellten Parameter und ihrer Verwendung finden Sie unter VehicleWaypointMarkerCustomizationFunctionParams.
intermediateDestinationMarkerCustomization optional
Anpassungen, die auf die Markierungen für Zwischenziele von Fahrzeugfahrten angewendet werden.

In diesem Feld können Sie benutzerdefiniertes Styling (z. B. ein Markierungssymbol) und Interaktivität (z. B. Klickbehandlung) angeben.
  • Wenn ein MarkerOptions-Objekt angegeben ist, werden die darin angegebenen Änderungen nach dem Erstellen der Markierung auf die Markierung angewendet. Die Standardoptionen werden dabei überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie einmal beim Erstellen der Markierung aufgerufen, bevor sie der Kartenansicht hinzugefügt wird. Bei dieser Aufrufung wird der Parameter isNew im Objekt „function parameters“ auf true festgelegt. Außerdem wird diese Funktion aufgerufen, wenn der Standortanbieter Daten von der Fleet Engine empfängt, unabhängig davon, ob sich die Daten für diese Markierung geändert haben.

    Eine Liste der bereitgestellten Parameter und ihrer Verwendung finden Sie unter VehicleWaypointMarkerCustomizationFunctionParams.
originMarkerCustomization optional
Anpassung, die auf die Markierung des Startpunkts der Fahrt angewendet wurde.

In diesem Feld können Sie benutzerdefiniertes Styling (z. B. ein Markierungssymbol) und Interaktivität (z. B. Klickbehandlung) angeben.
  • Wenn ein MarkerOptions-Objekt angegeben ist, werden die darin angegebenen Änderungen nach dem Erstellen der Markierung auf die Markierung angewendet. Die Standardoptionen werden dabei überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie einmal beim Erstellen der Markierung aufgerufen, bevor sie der Kartenansicht hinzugefügt wird. Bei dieser Aufrufung wird der Parameter isNew im Objekt „function parameters“ auf true festgelegt. Außerdem wird diese Funktion aufgerufen, wenn der Standortanbieter Daten von der Fleet Engine empfängt, unabhängig davon, ob sich die Daten für diese Markierung geändert haben.

    Eine Liste der bereitgestellten Parameter und ihrer Verwendung finden Sie unter VehicleWaypointMarkerCustomizationFunctionParams.
pollingIntervalMillis optional
Typ:number optional
Mindestzeit zwischen dem Abrufen von Standortaktualisierungen in Millisekunden. Wenn das Abrufen eines Standortupdates länger als pollingIntervalMillis dauert, wird das nächste Standortupdate erst gestartet, wenn das aktuelle abgeschlossen ist.

Wenn Sie diesen Wert auf „0“ setzen, werden wiederkehrende Standortaktualisierungen deaktiviert. Ein neuer Standort wird abgerufen, wenn sich einer der vom Standortanbieter beobachteten Parameter ändert.

Das Standard-Polling-Intervall beträgt 5.000 Millisekunden, das Mindestintervall. Wenn Sie das Polling-Intervall auf einen niedrigeren Wert ungleich null festlegen, wird 5.000 verwendet.
remainingPolylineCustomization optional
Anpassung, die auf die verbleibende Polylinie angewendet wird. Eine verbleibende Polylinie entspricht einem Teil der Route, den das Fahrzeug noch nicht befahren hat.

In diesem Feld können Sie benutzerdefiniertes Styling (z. B. Polylinienfarbe) und Interaktivität (z. B. Klickbehandlung) angeben.
  • Wenn ein PolylineOptions-Objekt angegeben ist, werden die darin angegebenen Änderungen nach dem Erstellen der Polylinie auf die Polylinie angewendet. Die Standardoptionen werden dabei überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie beim Erstellen der Polylinie einmal aufgerufen. Bei dieser Aufrufung wird der Parameter isNew im Objekt „function parameters“ auf true gesetzt. Außerdem wird diese Funktion aufgerufen, wenn sich die Koordinaten der Polylinie ändern oder der Standortanbieter Daten von der Fleet Engine empfängt, unabhängig davon, ob sich die Daten für diese Polylinie geändert haben.

    Eine Liste der bereitgestellten Parameter und ihrer Verwendung finden Sie unter VehiclePolylineCustomizationFunctionParams.
staleLocationThresholdMillis optional
Typ:number optional
Grenzwert für veralteten Fahrzeugstandort. Wenn der zuletzt aktualisierte Standort des Fahrzeugs älter als dieser Grenzwert ist, wird das Fahrzeug nicht angezeigt. Standardmäßig 24 Stunden in Millisekunden. Wenn der Grenzwert unter 0 oder Unendlich liegt, wird er ignoriert und der Fahrzeugstandort wird nicht als veraltet betrachtet.
takenPolylineCustomization optional
Anpassungen, die auf die aufgenommene Polylinie angewendet wurden. Eine zurückgelegte Polylinie entspricht einem Teil der Route, den das Fahrzeug bereits zurückgelegt hat.

In diesem Feld können Sie benutzerdefiniertes Styling (z. B. Polylinienfarbe) und Interaktivität (z. B. Klickbehandlung) angeben.
  • Wenn ein PolylineOptions-Objekt angegeben ist, werden die darin angegebenen Änderungen nach dem Erstellen der Polylinie auf die Polylinie angewendet. Die Standardoptionen werden dabei überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie beim Erstellen der Polylinie einmal aufgerufen. Bei dieser Aufrufung wird der Parameter isNew im Objekt „function parameters“ auf true gesetzt. Außerdem wird diese Funktion aufgerufen, wenn sich die Koordinaten der Polylinie ändern oder der Standortanbieter Daten von der Fleet Engine empfängt, unabhängig davon, ob sich die Daten für diese Polylinie geändert haben.

    Eine Liste der bereitgestellten Parameter und ihrer Verwendung finden Sie unter VehiclePolylineCustomizationFunctionParams.
vehicleId optional
Typ:string optional
Die Fahrzeug-ID, die unmittelbar nach der Instanziierung des Standortanbieters erfasst werden soll. Wenn keine ID angegeben ist, beginnt der Standortanbieter nicht mit dem Tracking eines Fahrzeugs. Verwenden Sie FleetEngineVehicleLocationProvider.vehicleId, um die ID festzulegen und das Tracking zu starten.
vehicleMarkerCustomization optional
Anpassung, die auf die Fahrzeugmarkierung angewendet wurde.

In diesem Feld können Sie benutzerdefiniertes Styling (z. B. ein Markierungssymbol) und Interaktivität (z. B. Klickbehandlung) angeben.
  • Wenn ein MarkerOptions-Objekt angegeben ist, werden die darin angegebenen Änderungen nach dem Erstellen der Markierung auf die Markierung angewendet. Die Standardoptionen werden dabei überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie einmal beim Erstellen der Markierung aufgerufen, bevor sie der Kartenansicht hinzugefügt wird. Bei dieser Aufrufung wird der Parameter isNew im Objekt „function parameters“ auf true festgelegt. Außerdem wird diese Funktion aufgerufen, wenn der Standortanbieter Daten von der Fleet Engine empfängt, unabhängig davon, ob sich die Daten für diese Markierung geändert haben.

    Eine Liste der bereitgestellten Parameter und ihrer Verwendung finden Sie unter VehicleMarkerCustomizationFunctionParams.

FleetEngineVehicleLocationProviderUpdateEvent-Schnittstelle

google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent Benutzeroberfläche

Das Ereignisobjekt, das an den Ereignis-Handler übergeben wird, wenn das FleetEngineVehicleLocationProvider.update-Ereignis ausgelöst wird.

trips optional
Typ:Array<Trip> optional
Liste der Fahrten, die mit diesem Fahrzeug durchgeführt wurden. Nicht änderbar.
vehicle optional
Typ:Vehicle optional
Die vom Update zurückgegebene Fahrzeugdatenstruktur. Nicht änderbar.

Klasse FleetEngineFleetLocationProvider

google.maps.journeySharing.FleetEngineFleetLocationProvider Kurs

Anbieter für Standortermittlung von Fahrzeugen

Diese Klasse erweitert PollingLocationProvider.

Rufe const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
Parameter: 
Erstellt einen neuen Standortanbieter für Fahrzeuge, die von Fleet Engine erfasst werden.
locationRestriction
Die Grenzen, innerhalb derer Fahrzeuge erfasst werden sollen. Wenn keine Grenzen festgelegt sind, werden keine Fahrzeuge erfasst. Wenn Sie alle Fahrzeuge unabhängig vom Standort verfolgen möchten, legen Sie Grenzen fest, die der gesamten Erde entsprechen.
staleLocationThresholdMillis
Typ:number
Dieses Feld ist schreibgeschützt. Grenzwert für veralteten Fahrzeugstandort. Wenn der zuletzt aktualisierte Standort des Fahrzeugs älter als dieser Grenzwert ist, wird das Fahrzeug nicht angezeigt.
vehicleFilter
Typ:string optional
Der Filter, der beim Abrufen der Fahrzeuge angewendet wurde.
Übernommen:isPolling, pollingIntervalMillis
Übernommen:addListener
update
function(event)
Ereignis, das ausgelöst wird, wenn eine Anfrage zur Aktualisierung von Fleet Engine-Daten abgeschlossen ist.
Übernommen:ispollingchange

FleetEngineFleetLocationProviderOptions-Schnittstelle

google.maps.journeySharing.FleetEngineFleetLocationProviderOptions Benutzeroberfläche

Optionen für den Anbieter der Fahrzeugstandortermittlung.

authTokenFetcher
Stellt JSON Web Tokens für die Authentifizierung des Clients bei der Fleet Engine bereit.
projectId
Typ:string
Die Projekt-ID des Verbrauchers aus der Google Cloud Console.
locationRestriction optional
Die Breiten-/Längengradgrenzen, innerhalb derer Fahrzeuge sofort nach der Instanziierung des Standortanbieters geortet werden sollen. Wenn diese Variable nicht festgelegt ist, beginnt der Standortanbieter nicht mit dem Tracking von Fahrzeugen. Verwenden Sie FleetEngineFleetLocationProvider.locationRestriction, um die Grenzen festzulegen und mit dem Tracking zu beginnen. Wenn Sie alle Fahrzeuge unabhängig vom Standort verfolgen möchten, legen Sie Grenzen fest, die der gesamten Erde entsprechen.
staleLocationThresholdMillis optional
Typ:number optional
Grenzwert für veralteten Fahrzeugstandort. Wenn der zuletzt aktualisierte Standort des Fahrzeugs älter als dieser Grenzwert ist, wird das Fahrzeug nicht angezeigt. Standardmäßig 24 Stunden in Millisekunden. Wenn der Grenzwert kleiner als null oder Unendlich ist, wird er ignoriert und der Fahrzeugstandort gilt nicht als veraltet.
vehicleFilter optional
Typ:string optional
Eine Filterabfrage, die beim Abrufen von Fahrzeugen angewendet werden soll. Dieser Filter wird direkt an die Fleet Engine übergeben.

Unter ListVehiclesRequest.filter finden Sie Informationen zu den unterstützten Formaten.

Gültige Filter für Attribute müssen das Präfix „attributes“ haben. Beispiel: attributes.x = "y" oder attributes."x y" = "z".
vehicleMarkerCustomization optional
Typ:function(VehicleMarkerCustomizationFunctionParams): void optional
Anpassung, die auf eine Fahrzeugmarkierung angewendet wurde.

In diesem Feld können Sie benutzerdefiniertes Styling (z. B. ein Markierungssymbol) und Interaktivität (z. B. Klickbehandlung) angeben.
  • Wenn ein MarkerOptions-Objekt angegeben ist, werden die darin angegebenen Änderungen nach dem Erstellen der Markierung auf die Markierung angewendet. Die Standardoptionen werden dabei überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie einmal beim Erstellen der Markierung aufgerufen, bevor sie der Kartenansicht hinzugefügt wird. Bei dieser Aufrufung wird der Parameter isNew im Objekt „function parameters“ auf true festgelegt. Außerdem wird diese Funktion aufgerufen, wenn der Standortanbieter Daten von der Fleet Engine empfängt, unabhängig davon, ob sich die Daten für diese Markierung geändert haben.

    Eine Liste der bereitgestellten Parameter und ihrer Verwendung finden Sie unter VehicleMarkerCustomizationFunctionParams.

FleetEngineFleetLocationProviderUpdateEvent-Schnittstelle

google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent Benutzeroberfläche

Das Ereignisobjekt, das an den Ereignis-Handler übergeben wird, wenn das FleetEngineFleetLocationProvider.update-Ereignis ausgelöst wird.

vehicles optional
Typ:Array<Vehicle> optional
Die Liste der Fahrzeuge, die von der Abfrage zurückgegeben werden. Nicht änderbar.