Shipment Tracking

Klasa FleetEngineShipmentLocationProvider

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

Dostawca lokalizacji przesyłki.

const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
Parametry:
Tworzy nowego dostawcę lokalizacji na potrzeby śledzenia przesyłek w Fleet Engine.
trackingId
Typ: string
Identyfikator śledzenia zadania, które obserwuje ten dostawca lokalizacji. Ustaw to pole, aby rozpocząć śledzenie.
Dziedziczone: isPolling, pollingIntervalMillis
refresh
refresh()
Parametry: brak
Wartość zwracana: void
Wyraźnie odświeża śledzoną lokalizację.
Dziedziczone: addListener
error
function(event)
Argumenty:
Zdarzenie wywoływane, gdy dostawca lokalizacji napotka błąd.
update
function(event)
Zdarzenie wywoływane po zakończeniu żądania aktualizacji danych Fleet Engine.
Dziedziczone: ispollingchange

Interfejs FleetEngineShipmentLocationProviderOptions

Interfejs google.maps.journeySharing.FleetEngineShipmentLocationProviderOptions

Opcje dostawcy lokalizacji przesyłki.

authTokenFetcher
Udostępnia tokeny sieciowe JSON do uwierzytelniania klienta w Fleet Engine.
projectId
Typ: string
Identyfikator projektu klienta z konsoli Google Cloud.
activePolylineCustomization
opcjonalne
Dostosowanie zastosowane do aktywnej linii łamanej. Aktywna linia łamana odpowiada części trasy, którą pojazd aktualnie pokonuje.

Użyj tego pola, aby określić styl niestandardowy (np. kolor linii łamanej) i interaktywność (np. obsługę kliknięć).
  • Jeśli określono obiekt PolylineOptions, zmiany w nim określone są stosowane do linii łamanej po jej utworzeniu, zastępując jej opcje domyślne, jeśli istnieją.
  • Jeśli funkcja jest określona, jest wywoływana raz podczas tworzenia linii łamanej. (W tym wywołaniu parametr isNew w obiekcie parametrów funkcji jest ustawiony na true). Dodatkowo ta funkcja jest wywoływana, gdy zmieniają się współrzędne linii łamanej lub gdy dostawca lokalizacji otrzymuje dane z Fleet Engine, niezależnie od tego, czy dane odpowiadające tej linii łamanej uległy zmianie.

    Listę dostarczonych parametrów i ich zastosowań znajdziesz w ShipmentPolylineCustomizationFunctionParams.
deliveryVehicleMarkerCustomization
opcjonalne
Dostosowanie zastosowane do znacznika pojazdu dostawczego.

Użyj tego pola, aby określić styl niestandardowy (np. ikonę znacznika) i interaktywność (np. obsługę kliknięć).
  • Jeśli określono obiekt MarkerOptions, zmiany w nim określone są stosowane do znacznika po jego utworzeniu, zastępując jego opcje domyślne, jeśli istnieją.
  • Jeśli funkcja jest określona, jest wywoływana raz podczas tworzenia znacznika, zanim zostanie on dodany do widoku mapy. (W tym wywołaniu parametr isNew w obiekcie parametrów funkcji jest ustawiony na true). Dodatkowo ta funkcja jest wywoływana, gdy dostawca lokalizacji otrzymuje dane z silnika Fleet Engine, niezależnie od tego, czy dane odpowiadające temu znacznikowi uległy zmianie.

    Listę dostarczonych parametrów i ich zastosowań znajdziesz w ShipmentMarkerCustomizationFunctionParams.
destinationMarkerCustomization
opcjonalne
Dostosowanie zastosowane do znacznika miejsca docelowego.

Użyj tego pola, aby określić styl niestandardowy (np. ikonę znacznika) i interaktywność (np. obsługę kliknięć).
  • Jeśli określono obiekt MarkerOptions, zmiany w nim określone są stosowane do znacznika po jego utworzeniu, zastępując jego opcje domyślne, jeśli istnieją.
  • Jeśli funkcja jest określona, jest wywoływana raz podczas tworzenia znacznika, zanim zostanie on dodany do widoku mapy. (W tym wywołaniu parametr isNew w obiekcie parametrów funkcji jest ustawiony na true). Dodatkowo ta funkcja jest wywoływana, gdy dostawca lokalizacji otrzymuje dane z silnika Fleet Engine, niezależnie od tego, czy dane odpowiadające temu znacznikowi uległy zmianie.

    Listę dostarczonych parametrów i ich zastosowań znajdziesz w ShipmentMarkerCustomizationFunctionParams.
pollingIntervalMillis
opcjonalne
Typ: number optional
Minimalny czas między pobieraniem informacji o zmianie lokalizacji w milisekundach. Jeśli pobranie informacji o zmianie lokalizacji trwa dłużej niż pollingIntervalMillis, następna informacja o zmianie lokalizacji nie zostanie rozpoczęta, dopóki nie zakończy się bieżąca.

Ustawienie tej wartości na 0, Infinity lub wartość ujemną wyłącza automatyczne aktualizacje lokalizacji. Nowa informacja o zmianie lokalizacji jest pobierana raz, jeśli zmieni się parametr identyfikatora śledzenia (np. identyfikator śledzenia przesyłki dostawcy lokalizacji przesyłki) lub opcja filtrowania (np. granice widocznego obszaru lub filtry atrybutów dla dostawców lokalizacji floty).

Domyślny i minimalny odstęp sondowania to 5000 milisekund. Jeśli ustawisz odstęp sondowania na mniejszą wartość dodatnią, zostanie zapisana i użyta wartość 5000.
remainingPolylineCustomization
opcjonalne
Dostosowanie zastosowane do pozostałej części linii łamanej. Pozostała linia łamana odpowiada części trasy, której pojazd jeszcze nie zaczął pokonywać.

Użyj tego pola, aby określić styl niestandardowy (np. kolor linii łamanej) i interaktywność (np. obsługę kliknięć).
  • Jeśli określono obiekt PolylineOptions, zmiany w nim określone są stosowane do linii łamanej po jej utworzeniu, zastępując jej opcje domyślne, jeśli istnieją.
  • Jeśli funkcja jest określona, jest wywoływana raz podczas tworzenia linii łamanej. (W tym wywołaniu parametr isNew w obiekcie parametrów funkcji jest ustawiony na true). Dodatkowo ta funkcja jest wywoływana, gdy zmieniają się współrzędne linii łamanej lub gdy dostawca lokalizacji otrzymuje dane z Fleet Engine, niezależnie od tego, czy dane odpowiadające tej linii łamanej uległy zmianie.

    Listę dostarczonych parametrów i ich zastosowań znajdziesz w ShipmentPolylineCustomizationFunctionParams.
takenPolylineCustomization
opcjonalne
Dostosowanie zastosowane do wybranej linii łamanej. Linia łamana przebytej trasy odpowiada części trasy, którą pojazd już pokonał.

Użyj tego pola, aby określić styl niestandardowy (np. kolor linii łamanej) i interaktywność (np. obsługę kliknięć).
  • Jeśli określono obiekt PolylineOptions, zmiany w nim określone są stosowane do linii łamanej po jej utworzeniu, zastępując jej opcje domyślne, jeśli istnieją.
  • Jeśli funkcja jest określona, jest wywoływana raz podczas tworzenia linii łamanej. (W tym wywołaniu parametr isNew w obiekcie parametrów funkcji jest ustawiony na true). Dodatkowo ta funkcja jest wywoływana, gdy zmieniają się współrzędne linii łamanej lub gdy dostawca lokalizacji otrzymuje dane z Fleet Engine, niezależnie od tego, czy dane odpowiadające tej linii łamanej uległy zmianie.

    Listę dostarczonych parametrów i ich zastosowań znajdziesz w ShipmentPolylineCustomizationFunctionParams.
trackingId
opcjonalne
Typ: string optional
Identyfikator śledzenia zadania, które ma być śledzone natyczmiast po utworzeniu instancji dostawcy lokalizacji. Jeśli nie podasz identyfikatora, dostawca lokalizacji nie zacznie śledzić żadnego zadania. Aby ustawić identyfikator śledzenia i rozpocząć śledzenie, użyj metody FleetEngineShipmentLocationProvider.trackingId.

Interfejs FleetEngineShipmentLocationProviderUpdateEvent

Interfejs google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent

Obiekt zdarzenia przekazywany do modułu obsługi zdarzeń po wywołaniu zdarzenia FleetEngineShipmentLocationProvider.update.

taskTrackingInfo
opcjonalne
Typ: TaskTrackingInfo optional
Struktura informacji o śledzeniu zadań zwracana przez aktualizację. Nie można go modyfikować.