Shipment Tracking

FleetEngineShipmentLocationProvider-Klasse

google.maps.journeySharing.FleetEngineShipmentLocationProvider class
extends PollingLocationProvider
library "journeySharing"

Anbieter von Versandstandorten.

const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
Parameter:
Erstellt einen neuen Standortanbieter für die Fleet Engine-Sendungsverfolgung.
trackingId
Typ: string
Die Tracking-ID für die Aufgabe, die dieser Standortanbieter beobachtet. Legen Sie dieses Feld fest, um mit dem Tracking zu beginnen.
Übernommen: isPolling, pollingIntervalMillis
refresh
refresh()
Parameter: Keine
Rückgabewert: void
Aktualisiert den erfassten Standort explizit.
Ü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

FleetEngineShipmentLocationProviderOptions-Schnittstelle

Schnittstelle google.maps.journeySharing.FleetEngineShipmentLocationProviderOptions

Optionen für den Anbieter des Versandorts.

authTokenFetcher
Stellt JSON-Webtokens für die Authentifizierung des Clients bei der Fleet Engine bereit.
projectId
Typ: string
Die Projekt-ID des Nutzers 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 durchfährt.

In diesem Feld können Sie benutzerdefinierte Stile (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 diese angewendet. Dabei werden die Standardoptionen überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie einmal aufgerufen, wenn die Polylinie erstellt wird. Bei diesem Aufruf wird der Parameter isNew im Objekt mit den Funktionsparametern auf true gesetzt. Außerdem wird diese Funktion aufgerufen, wenn sich die Koordinaten der Polylinie ändern oder wenn der Standortanbieter Daten von 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 ShipmentPolylineCustomizationFunctionParams.
deliveryVehicleMarkerCustomization
optional
Anpassung, die auf die Markierung des Lieferfahrzeugs angewendet wird.

In diesem Feld können Sie benutzerdefinierte Stile (z. B. Markierungssymbole) und Interaktivität (z. B. Klickverarbeitung) angeben.
  • Wenn ein MarkerOptions-Objekt angegeben ist, werden die darin angegebenen Änderungen nach dem Erstellen der Markierung auf diese angewendet. Dabei werden die Standardoptionen überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie einmal aufgerufen, wenn die Markierung erstellt wird, bevor sie der Kartenansicht hinzugefügt wird. Bei diesem Aufruf wird der Parameter isNew im Objekt mit den Funktionsparametern auf true gesetzt. Außerdem wird diese Funktion aufgerufen, wenn der Standortanbieter Daten von 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 ShipmentMarkerCustomizationFunctionParams.
destinationMarkerCustomization
optional
Anpassung, die auf die Zielmarkierung angewendet wird.

In diesem Feld können Sie benutzerdefinierte Stile (z. B. Markierungssymbole) und Interaktivität (z. B. Klickverarbeitung) angeben.
  • Wenn ein MarkerOptions-Objekt angegeben ist, werden die darin angegebenen Änderungen nach dem Erstellen der Markierung auf diese angewendet. Dabei werden die Standardoptionen überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie einmal aufgerufen, wenn die Markierung erstellt wird, bevor sie der Kartenansicht hinzugefügt wird. Bei diesem Aufruf wird der Parameter isNew im Objekt mit den Funktionsparametern auf true gesetzt. Außerdem wird diese Funktion aufgerufen, wenn der Standortanbieter Daten von 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 ShipmentMarkerCustomizationFunctionParams.
pollingIntervalMillis
optional
Typ: number optional
Mindestzeit zwischen dem Abrufen von Standortaktualisierungen in Millisekunden. Wenn das Abrufen eines Standort-Updates länger als pollingIntervalMillis dauert, wird das nächste Standort-Update erst gestartet, wenn das aktuelle abgeschlossen ist.

Wenn Sie diesen Wert auf 0, unendlich oder einen negativen Wert setzen, werden automatische Standortaktualisierungen deaktiviert. Ein neues Standort-Update wird einmalig abgerufen, wenn sich der Tracking-ID-Parameter (z. B. die Sendungsverfolgungs-ID des Anbieters von Sendungsstandorten) oder eine Filteroption (z. B. Darstellungsbereichsgrenzen oder Attributfilter für Anbieter von Flottenstandorten) ändert.

Das standardmäßige und minimale Abfrageintervall beträgt 5.000 Millisekunden. Wenn Sie das Abfrageintervall auf einen niedrigeren positiven Wert festlegen, wird 5000 gespeichert und 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 benutzerdefinierte Stile (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 diese angewendet. Dabei werden die Standardoptionen überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie einmal aufgerufen, wenn die Polylinie erstellt wird. Bei diesem Aufruf wird der Parameter isNew im Objekt mit den Funktionsparametern auf true gesetzt. Außerdem wird diese Funktion aufgerufen, wenn sich die Koordinaten der Polylinie ändern oder wenn der Standortanbieter Daten von 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 ShipmentPolylineCustomizationFunctionParams.
takenPolylineCustomization
optional
Anpassung, die auf die verwendete Polylinie angewendet wird. Eine Polylinie für die zurückgelegte Strecke entspricht einem Teil der Route, den das Fahrzeug bereits zurückgelegt hat.

In diesem Feld können Sie benutzerdefinierte Stile (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 diese angewendet. Dabei werden die Standardoptionen überschrieben, falls vorhanden.
  • Wenn eine Funktion angegeben ist, wird sie einmal aufgerufen, wenn die Polylinie erstellt wird. Bei diesem Aufruf wird der Parameter isNew im Objekt mit den Funktionsparametern auf true gesetzt. Außerdem wird diese Funktion aufgerufen, wenn sich die Koordinaten der Polylinie ändern oder wenn der Standortanbieter Daten von 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 ShipmentPolylineCustomizationFunctionParams.
trackingId
optional
Typ: string optional
Die Tracking-ID der Aufgabe, die unmittelbar nach der Instanziierung des Standortanbieters verfolgt werden soll. Wenn nicht angegeben, beginnt der Standortanbieter nicht mit dem Tracking einer Aufgabe. Verwenden Sie FleetEngineShipmentLocationProvider.trackingId, um die Tracking-ID festzulegen und mit dem Tracking zu beginnen.

FleetEngineShipmentLocationProviderUpdateEvent-Schnittstelle

Schnittstelle google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent

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

taskTrackingInfo
optional
Typ: TaskTrackingInfo optional
Die von der Aktualisierung zurückgegebene Struktur der Aufgaben-Tracker-Informationen. Nicht änderbar.