Shipment Tracking

Klasa FleetEngineShipmentLocationProvider

google.maps.journeySharing.FleetEngineShipmentLocationProvider zajęcia

Dostawca miejsca dostawy.

Te zajęcia są rozszerzone na PollingLocationProvider.

Aby uzyskać dostęp, zadzwoń pod numer const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę lokalizacji na potrzeby śledzenia przesyłek Fleet Engine.
trackingId
Typ:  string
Identyfikator śledzenia dla zadania obserwowanego przez tego dostawcę lokalizacji. Ustaw to pole, aby rozpocząć śledzenie.
Odziedziczone: isPolling, pollingIntervalMillis
refresh
refresh()
Parametry: brak
Wartość zwrotu:  void
Wyraźnie odświeża śledzoną lokalizację.
Odziedziczone: 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.
Odziedziczone: ispollingchange

Interfejs FleetEngineShipmentLocationProviderOptions

google.maps.journeySharing.FleetEngineShipmentLocationProviderOptions interfejs

Opcje dla dostawcy miejsca wysyłki.

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

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 określone w nim zostaną zastosowane do linii łamanej po jej utworzeniu, zastępując dostępne w nim opcje domyślne.
  • Jeśli funkcja jest określona, jest wywoływana raz podczas tworzenia linii łamanej. (Przy tym wywołaniu parametr isNew w obiekcie parametrów funkcji jest ustawiony na true). Dodatkowo ta funkcja jest wywoływana po zmianie współrzędnych linii łamanej lub gdy dostawca lokalizacji otrzyma dane z Fleet Engine, niezależnie od tego, czy zmieniły się dane odpowiadające tej linii łamanej.

    Listę dostarczanych parametrów i ich zastosowań znajdziesz na stronie ShipmentPolylineCustomizationFunctionParams.
deliveryVehicleMarkerCustomization optional
Dostosowanie 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ślony jest obiekt MarkerOptions, określone w nim zmiany zostaną zastosowane do znacznika po jego utworzeniu, zastępując dostępne w nim opcje domyślne.
  • Jeśli funkcja jest określona, jest wywoływana raz podczas tworzenia znacznika, przed dodaniem jej do widoku mapy. (Przy tym wywołaniu parametr isNew w obiekcie parametrów funkcji jest ustawiony na true). Dodatkowo ta funkcja jest wywoływana, gdy dostawca lokalizacji otrzyma dane z Fleet Engine bez względu na to, czy dane odpowiadające temu znacznikowi uległy zmianie.

    Lista parametrów i ich zastosowania znajdziesz w sekcji ShipmentMarkerCustomizationFunctionParams.
destinationMarkerCustomization optional
Dostosowanie do znacznika miejsca docelowego zostało zastosowane.

Użyj tego pola, aby określić styl niestandardowy (np. ikonę znacznika) i interaktywność (np. obsługę kliknięć).
  • Jeśli określony jest obiekt MarkerOptions, określone w nim zmiany zostaną zastosowane do znacznika po jego utworzeniu, zastępując dostępne w nim opcje domyślne.
  • Jeśli funkcja jest określona, jest wywoływana raz podczas tworzenia znacznika, przed dodaniem jej do widoku mapy. (Przy tym wywołaniu parametr isNew w obiekcie parametrów funkcji jest ustawiony na true). Dodatkowo ta funkcja jest wywoływana, gdy dostawca lokalizacji otrzyma dane z Fleet Engine bez względu na to, czy dane odpowiadające temu znacznikowi uległy zmianie.

    Lista parametrów i ich zastosowania znajdziesz w sekcji ShipmentMarkerCustomizationFunctionParams.
pollingIntervalMillis optional
Typ:  number optional
Minimalny czas (w milisekundach) pomiędzy pobraniem aktualizacji lokalizacji. Jeśli pobranie aktualizacji lokalizacji trwa dłużej niż pollingIntervalMillis, następna aktualizacja lokalizacji rozpocznie się dopiero po zakończeniu bieżącej.

Ustawienie tej wartości na 0, Infinity lub wartość ujemną wyłącza automatyczne aktualizacje lokalizacji. Nowa aktualizacja lokalizacji jest pobierana raz w przypadku zmiany parametru identyfikatora śledzenia (np. identyfikatora śledzenia przesyłki dostawcy miejsca przesyłki) lub opcji filtrowania (na przykład granic widocznego obszaru lub filtrów atrybutów w przypadku dostawców lokalizacji floty).

Domyślny i minimalny interwał odpytywania to 5000 milisekund. Jeśli dla interwału odpytywania ustawisz niższą wartość dodatnią, wartość 5000 będzie przechowywana i używana.
remainingPolylineCustomization optional
Dostosowanie zostało zastosowane do pozostałej linii łamanej. Pozostała linia łamana odpowiada części trasy, przez którą pojazd się jeszcze nie rozpoczął.

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 określone w nim zostaną zastosowane do linii łamanej po jej utworzeniu, zastępując dostępne w nim opcje domyślne.
  • Jeśli funkcja jest określona, jest wywoływana raz podczas tworzenia linii łamanej. (Przy tym wywołaniu parametr isNew w obiekcie parametrów funkcji jest ustawiony na true). Dodatkowo ta funkcja jest wywoływana po zmianie współrzędnych linii łamanej lub gdy dostawca lokalizacji otrzyma dane z Fleet Engine, niezależnie od tego, czy zmieniły się dane odpowiadające tej linii łamanej.

    Listę dostarczanych parametrów i ich zastosowań znajdziesz na stronie ShipmentPolylineCustomizationFunctionParams.
takenPolylineCustomization optional
Dostosowanie zastosowane do pobranej linii łamanej. Zajęta linia łamana odpowiada części trasy, którą pokonał już pojazd.

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 określone w nim zostaną zastosowane do linii łamanej po jej utworzeniu, zastępując dostępne w nim opcje domyślne.
  • Jeśli funkcja jest określona, jest wywoływana raz podczas tworzenia linii łamanej. (Przy tym wywołaniu parametr isNew w obiekcie parametrów funkcji jest ustawiony na true). Dodatkowo ta funkcja jest wywoływana po zmianie współrzędnych linii łamanej lub gdy dostawca lokalizacji otrzyma dane z Fleet Engine, niezależnie od tego, czy zmieniły się dane odpowiadające tej linii łamanej.

    Listę dostarczanych parametrów i ich zastosowań znajdziesz na stronie ShipmentPolylineCustomizationFunctionParams.
trackingId optional
Typ:  string optional
Identyfikator śledzenia zadania do monitorowania natychmiast po utworzeniu instancji dostawcy lokalizacji. Jeśli go nie podasz, dostawca lokalizacji nie rozpocznie śledzenia żadnego zadania. Aby ustawić identyfikator śledzenia i rozpocząć śledzenie, użyj parametru FleetEngineShipmentLocationProvider.trackingId.

Interfejs FleetEngineShipmentLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent interfejs

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

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