Shipment Tracking

klasa FleetEngineShipmentLocationProvider

google.maps.journeySharing.FleetEngineShipmentLocationProvider class

dostawca lokalizacji przesyłki,

Te zajęcia trwają PollingLocationProvider.

Dostęp przez połączenie telefoniczne const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w Maps JavaScript API.
FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę danych o lokalizacji na potrzeby śledzenia przesyłek w ramach usługi Fleet Engine.
trackingId
Typ:  string
Identyfikator śledzenia zadania, które obserwuje dostawca lokalizacji. Aby rozpocząć śledzenie, ustaw to pole.
Uzyskane: isPolling, pollingIntervalMillis
refresh
refresh()
Parametry: brak
Wartość zwracana:  void
wyraźnie odświeża śledzoną lokalizację;
Podane z poziomu klasy: addListener
error
function(event)
Argumenty: 
Zdarzenie, które jest wywoływane, gdy dostawca lokalizacji napotka błąd.
update
function(event)
Argumenty: 
Zdarzenie, które jest wywoływane po zakończeniu przetwarzania żądania aktualizacji danych silnika floty.
Podane z poziomu klasy: ispollingchange

Interfejs FleetEngineShipmentLocationProviderOptions

google.maps.journeySharing.FleetEngineShipmentLocationProviderOptionsinterfejs

Opcje dostawcy lokalizacji przesyłki.
authTokenFetcher
Udostępnia tokeny sieciowe JSON do uwierzytelniania klienta w Fleet Engine.
projectId
Typ:  string
Identyfikator projektu konsumenta z konsoli Google Cloud.
activePolylineCustomization optional
Personalizacja zastosowana do aktywnej polilinii. Aktywna linia łamana odpowiada części trasy, którą pojazd aktualnie przemierza.

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

    Listę dostępnych parametrów i ich zastosowań znajdziesz w dokumentacji ShipmentPolylineCustomizationFunctionParams.
deliveryVehicleMarkerCustomization optional
Dostosowywanie zastosowane do znacznika pojazdu dostawczego.

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

    Listę dostępnych parametrów i ich zastosowań znajdziesz w dokumentacji ShipmentMarkerCustomizationFunctionParams.
destinationMarkerCustomization optional
Dostosowywanie zastosowane do znacznika miejsca docelowego.

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

    Listę dostępnych parametrów i ich zastosowań znajdziesz w dokumentacji ShipmentMarkerCustomizationFunctionParams.
pollingIntervalMillis optional
Typ:  number optional
Minimalny czas między pobieraniem aktualizacji lokalizacji w milisekundach. Jeśli pobranie aktualizacji lokalizacji zajmuje więcej niż pollingIntervalMillis, następna aktualizacja lokalizacji nie rozpocznie się, dopóki nie zakończy się bieżąca aktualizacja.

Ustawienie tej wartości na 0, „Infinity” lub wartość ujemna powoduje wyłączenie automatycznych aktualizacji lokalizacji. Nowe powiadomienie o zmianie lokalizacji jest pobierane raz, gdy zmieni się parametr identyfikatora śledzenia (np. identyfikator śledzenia przesyłki dostawcy lokalizacji przesyłki) lub opcja filtrowania (np. granice widoku lub filtry atrybutów dostawców lokalizacji floty).

Domyślny i minimalny interwał sondowania wynosi 5000 milisekund. Jeśli ustawisz interwał sondowania na niższą wartość dodatnią, zostanie zapisana i użyta wartość 5000.
remainingPolylineCustomization optional
Personalizacja zastosowana do pozostałej części polilinii. Pozostała linia łamana odpowiada części trasy, którą pojazd jeszcze nie przejechał.

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

    Listę dostępnych parametrów i ich zastosowań znajdziesz w dokumentacji ShipmentPolylineCustomizationFunctionParams.
takenPolylineCustomization optional
Dostosowanie zastosowane do wybranej linii łamanej. Przebyta linia łamana odpowiada części trasy, którą pojazd już przebył.

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

    Listę dostępnych parametrów i ich zastosowań znajdziesz w dokumentacji ShipmentPolylineCustomizationFunctionParams.
trackingId optional
Typ:  string optional
Identyfikator śledzenia zadania do śledzenia, który jest tworzony natychmiast po uruchomieniu dostawcy lokalizacji. Jeśli nie zostanie określony, dostawca lokalizacji nie rozpocznie śledzenia żadnego zadania. Aby ustawić identyfikator śledzenia i rozpocząć śledzenie, użyj FleetEngineShipmentLocationProvider.trackingId.

FleetEngineShipmentLocationProviderUpdateEvent interfejs

google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEventinterfejs

Obiekt zdarzenia przekazany do modułu obsługi zdarzenia, gdy zostanie wywołane zdarzenie FleetEngineShipmentLocationProvider.update.
taskTrackingInfo optional
Typ:  TaskTrackingInfo optional
Struktura informacji o śledzeniu zadań zwracana przez aktualizację. Nie można ich modyfikować.