Fleet Tracking - Last Mile Fleet

FleetEngineDeliveryVehicleLocationProvider class

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider zajęcia

Dostawca lokalizacji pojazdu dostawczego.

Ta klasa rozszerza klasę PollingLocationProvider.

Dostęp przez połączenie pod numer const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing").
 Zobacz Biblioteki w Maps JavaScript API.

FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę lokalizacji dla pojazdu dostawczego Fleet Engine.
deliveryVehicleId
Typ:  string
Identyfikator pojazdu, który obserwuje ten dostawca lokalizacji. Ustaw to pole, aby śledzić pojazd.
shouldShowOutcomeLocations
Typ:  boolean optional
Opcjonalnie zezwól użytkownikom na wyświetlanie lokalizacji wyniku zadania.
shouldShowTasks
Typ:  boolean optional
Opcjonalnie zezwól użytkownikom na wyświetlanie pobranych zadań.
staleLocationThresholdMillis
Typ:  number
To pole jest tylko do odczytu. Próg dla nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza niż ta wartość progowa, pojazd nie będzie wyświetlany.
taskFilterOptions
Zwraca opcje filtrowania, które należy zastosować podczas pobierania zadań.
Przejęte: isPolling, pollingIntervalMillis
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 FleetEngineDeliveryVehicleLocationProviderOptions

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptionsinterfejs

Opcje dostawcy lokalizacji pojazdu dostawczego.

authTokenFetcher
Udostępnia tokeny sieciowe JSON do uwierzytelniania klienta w Fleet Engine.
projectId
Typ:  string
Identyfikator projektu konsumenta z Google Cloud Console.
activePolylineCustomization optional
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ć niestandardowy styl (np. kolor polilinii) i interaktywność (np. obsługę kliknięć).
  • Jeśli określony jest obiekt PolylineOptions, zmiany w nim podane są stosowane do polilinii po jej utworzeniu, zastępując jej opcje domyślne, jeśli takie istnieją.
  • Jeśli określono funkcję, jest ona wywoływana raz podczas tworzenia linii łamanej. (W tym wywołaniu 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ę dostarczonych parametrów i ich zastosowań znajdziesz w DeliveryVehiclePolylineCustomizationFunctionParams.
deliveryVehicleId optional
Typ:  string optional
Identyfikator pojazdu dostawczego, który ma być śledzony natychmiast po utworzeniu instancji dostawcy lokalizacji. Jeśli nie zostanie określony, dostawca lokalizacji nie rozpocznie śledzenia żadnego pojazdu. Aby ustawić identyfikator i rozpocząć śledzenie, użyj FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId.
deliveryVehicleMarkerCustomization optional
Dostosowanie 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 określony jest obiekt MarkerOptions, zmiany w nim zawarte są stosowane do znacznika po jego utworzeniu, co powoduje zastąpienie domyślnych opcji znacznika, jeśli takie istnieją.
  • Jeśli określono funkcję, jest ona wywoływana raz podczas tworzenia markera, zanim zostanie on dodany do widoku mapy. (W tym wywołaniu 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 markerowi uległy zmianie.

    Listę dostarczonych parametrów i ich zastosowań znajdziesz w DeliveryVehicleMarkerCustomizationFunctionParams.
plannedStopMarkerCustomization optional
Dostosowanie zastosowane do znacznika zaplanowanego przystanku.

Użyj tego pola, aby określić niestandardowy styl (np. ikonę znacznika) i interaktywność (np. obsługę kliknięć).
  • Jeśli określony jest obiekt MarkerOptions, zmiany w nim zawarte są stosowane do znacznika po jego utworzeniu, co powoduje zastąpienie domyślnych opcji znacznika, jeśli takie istnieją.
  • Jeśli określono funkcję, jest ona wywoływana raz podczas tworzenia markera, zanim zostanie on dodany do widoku mapy. (W tym wywołaniu 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 markerowi uległy zmianie.

    Listę dostarczonych parametrów i ich zastosowań znajdziesz w PlannedStopMarkerCustomizationFunctionParams.
pollingIntervalMillis optional
Typ:  number optional
Minimalny odstęp czasu między pobieraniem aktualizacji lokalizacji w milisekundach. Jeśli pobranie aktualizacji lokalizacji trwa dłużej niż pollingIntervalMillis, kolejna aktualizacja lokalizacji nie rozpocznie się, dopóki nie zakończy się bieżąca.

Ustawienie tej wartości na 0 wyłącza cykliczne aktualizacje lokalizacji. Nowa aktualizacja lokalizacji jest pobierana, jeśli zmieni się którykolwiek z parametrów obserwowanych przez dostawcę lokalizacji.

Domyślny odstęp sondowania to 5000 milisekund, czyli minimalny odstęp. Jeśli ustawisz interwał odpytywania na niższą wartość niezerową, zostanie użyta wartość 5000.
remainingPolylineCustomization optional
Dostosowanie zastosowane do pozostałej części polilinii. Pozostała linia łamana odpowiada części trasy, której pojazd jeszcze nie zaczął pokonywać.

Użyj tego pola, aby określić niestandardowy styl (np. kolor polilinii) i interaktywność (np. obsługę kliknięć).
  • Jeśli określony jest obiekt PolylineOptions, zmiany w nim podane są stosowane do polilinii po jej utworzeniu, zastępując jej opcje domyślne, jeśli takie istnieją.
  • Jeśli określono funkcję, jest ona wywoływana raz podczas tworzenia linii łamanej. (W tym wywołaniu 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ę dostarczonych parametrów i ich zastosowań znajdziesz w DeliveryVehiclePolylineCustomizationFunctionParams.
shouldShowOutcomeLocations optional
Typ:  boolean optional
Wartość logiczna określająca, czy wyświetlać lokalizacje wyników pobranych zadań.
shouldShowTasks optional
Typ:  boolean optional
Wartość logiczna określająca, czy zadania mają być widoczne. Jeśli ustawisz tę wartość na false, wywołanie punktu końcowego ListTasks w celu pobrania zadań nie będzie możliwe. Wyświetlane będą tylko nadchodzące przystanki.
staleLocationThresholdMillis optional
Typ:  number optional
Próg dla nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza niż ta wartość progowa, pojazd nie będzie wyświetlany. Domyślna wartość to 24 godziny w milisekundach. Jeśli wartość progowa jest mniejsza niż 0 lub nieskończoność, zostanie zignorowana, a lokalizacja pojazdu nie będzie uznawana za nieaktualną.
takenPolylineCustomization optional
Dostosowanie zastosowane do wybranej linii łamanej. Linia łamana odpowiada części trasy, którą pojazd już przejechał.

Użyj tego pola, aby określić niestandardowy styl (np. kolor polilinii) i interaktywność (np. obsługę kliknięć).
  • Jeśli określony jest obiekt PolylineOptions, zmiany w nim podane są stosowane do polilinii po jej utworzeniu, zastępując jej opcje domyślne, jeśli takie istnieją.
  • Jeśli określono funkcję, jest ona wywoływana raz podczas tworzenia linii łamanej. (W tym wywołaniu 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ę dostarczonych parametrów i ich zastosowań znajdziesz w DeliveryVehiclePolylineCustomizationFunctionParams.
taskFilterOptions optional
Opcje filtrowania do zastosowania podczas pobierania zadań. Opcje mogą obejmować konkretny pojazd, czas i stan zadania.
taskMarkerCustomization optional
Typ:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Dostosowanie zastosowane do znacznika zadania. Znacznik zadania jest renderowany w zaplanowanej lokalizacji każdego zadania przypisanego do pojazdu dostawczego.

Użyj tego pola, aby określić niestandardowy styl (np. ikonę znacznika) i interaktywność (np. obsługę kliknięć).
  • Jeśli określony jest obiekt MarkerOptions, zmiany w nim zawarte są stosowane do znacznika po jego utworzeniu, co powoduje zastąpienie domyślnych opcji znacznika, jeśli takie istnieją.
  • Jeśli określono funkcję, jest ona wywoływana raz podczas tworzenia markera, zanim zostanie on dodany do widoku mapy. (W tym wywołaniu 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 markerowi uległy zmianie.

    Listę dostarczonych parametrów i ich zastosowań znajdziesz w TaskMarkerCustomizationFunctionParams.
taskOutcomeMarkerCustomization optional
Typ:  function(TaskMarkerCustomizationFunctionParams): void optional
Dostosowanie zastosowane do znacznika wyniku zadania. Znacznik wyniku zadania jest renderowany w rzeczywistej lokalizacji wyniku każdego zadania przypisanego do pojazdu dostawczego.

Użyj tego pola, aby określić niestandardowy styl (np. ikonę znacznika) i interaktywność (np. obsługę kliknięć).
  • Jeśli określony jest obiekt MarkerOptions, zmiany w nim zawarte są stosowane do znacznika po jego utworzeniu, co powoduje zastąpienie domyślnych opcji znacznika, jeśli takie istnieją.
  • Jeśli określono funkcję, jest ona wywoływana raz podczas tworzenia markera, zanim zostanie on dodany do widoku mapy. (W tym wywołaniu 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 markerowi uległy zmianie.

    Listę dostarczonych parametrów i ich zastosowań znajdziesz w TaskMarkerCustomizationFunctionParams.

FleetEngineTaskFilterOptions interfejs

google.maps.journeySharing.FleetEngineTaskFilterOptionsinterfejs

Opcje filtrowania zadań w usłudze lokalizacji pojazdów dostawczych.

completionTimeFrom optional
Typ:  Date optional
Dolna granica czasu ukończenia zadania (wyłącznie). Służy do filtrowania zadań, które zostały wykonane po określonym czasie.
completionTimeTo optional
Typ:  Date optional
Wyłączna górna granica czasu ukończenia zadania. Służy do filtrowania zadań, które zostały ukończone przed określonym czasem.
state optional
Typ:  string optional
Stan zadania. Prawidłowe wartości to OPEN lub CLOSED.

FleetEngineDeliveryVehicleLocationProviderUpdateEvent interfejs

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEventinterfejs

Obiekt zdarzenia przekazywany do funkcji obsługi zdarzeń, gdy wywoływane jest zdarzenie FleetEngineDeliveryVehicleLocationProvider.update.

completedVehicleJourneySegments optional
Typ:  Array<VehicleJourneySegment> optional
Odcinki podróży, które zostały pokonane przez ten pojazd. Nie można go modyfikować.
deliveryVehicle optional
Typ:  DeliveryVehicle optional
Struktura danych pojazdu dostawczego zwrócona przez aktualizację. Nie można go modyfikować.
tasks optional
Typ:  Array<Task> optional
Lista zadań obsługiwanych przez ten pojazd dostawczy. Nie można go modyfikować.

FleetEngineDeliveryFleetLocationProvider class

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider zajęcia

Dostawca lokalizacji floty dostawczej.

Ta klasa rozszerza klasę PollingLocationProvider.

Dostęp przez połączenie pod numer const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing").
 Zobacz Biblioteki w Maps JavaScript API.

FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę lokalizacji dla pojazdów śledzonych przez Fleet Engine.
deliveryVehicleFilter
Typ:  string optional
Filtr zastosowany podczas pobierania pojazdów dostawczych.
locationRestriction
Granice, w których mają być śledzone pojazdy dostawcze. Jeśli nie ustawisz granic, żadne pojazdy dostawcze nie będą śledzone. Aby śledzić wszystkie pojazdy dostawcze niezależnie od lokalizacji, ustaw granice obejmujące całą Ziemię.
staleLocationThresholdMillis
Typ:  number
To pole jest tylko do odczytu. Próg dla nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza niż ta wartość progowa, pojazd nie będzie wyświetlany.
Przejęte: isPolling, pollingIntervalMillis
Dziedziczone: addListener
update
function(event)
Zdarzenie wywoływane po zakończeniu żądania aktualizacji danych Fleet Engine.
Dziedziczone: ispollingchange

Interfejs FleetEngineDeliveryFleetLocationProviderOptions

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptionsinterfejs

Opcje dostawcy lokalizacji floty dostawczej.

authTokenFetcher
Udostępnia tokeny sieciowe JSON do uwierzytelniania klienta w Fleet Engine.
projectId
Typ:  string
Identyfikator projektu konsumenta z Google Cloud Console.
deliveryVehicleFilter optional
Typ:  string optional
Zapytanie filtra do zastosowania podczas pobierania pojazdów dostawczych. Ten filtr jest przekazywany bezpośrednio do Fleet Engine.

Obsługiwane formaty znajdziesz w sekcji ListDeliveryVehiclesRequest.filter.

Pamiętaj, że prawidłowe filtry atrybutów muszą mieć prefiks „attributes”. Na przykład attributes.x = "y" lub attributes."x y" = "z".
deliveryVehicleMarkerCustomization optional
Typ:  function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional
Dostosowanie 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 określony jest obiekt MarkerOptions, zmiany w nim zawarte są stosowane do znacznika po jego utworzeniu, co powoduje zastąpienie domyślnych opcji znacznika, jeśli takie istnieją.
  • Jeśli określono funkcję, jest ona wywoływana raz podczas tworzenia markera, zanim zostanie on dodany do widoku mapy. (W tym wywołaniu 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 markerowi uległy zmianie.

    Listę dostarczonych parametrów i ich zastosowań znajdziesz w DeliveryVehicleMarkerCustomizationFunctionParams.
locationRestriction optional
Granice szerokości i długości geograficznej, w których należy śledzić pojazdy natychmiast po utworzeniu instancji dostawcy lokalizacji. Jeśli nie zostanie ustawiony, dostawca lokalizacji nie rozpocznie śledzenia żadnych pojazdów. Aby ustawić granice i rozpocząć śledzenie, użyj FleetEngineDeliveryFleetLocationProvider.locationRestriction. Aby śledzić wszystkie pojazdy dostawcze niezależnie od lokalizacji, ustaw granice obejmujące całą Ziemię.
staleLocationThresholdMillis optional
Typ:  number optional
Próg dla nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza niż ta wartość progowa, pojazd nie będzie wyświetlany. Domyślna wartość to 24 godziny w milisekundach. Jeśli wartość progowa jest mniejsza od zera lub wynosi nieskończoność, zostanie zignorowana, a lokalizacja pojazdu nie będzie uznawana za nieaktualną.

FleetEngineDeliveryFleetLocationProviderUpdateEvent interfejs

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEventinterfejs

Obiekt zdarzenia przekazywany do funkcji obsługi zdarzeń, gdy wywoływane jest zdarzenie FleetEngineDeliveryFleetLocationProvider.update.

deliveryVehicles optional
Typ:  Array<DeliveryVehicle> optional
Lista pojazdów dostawczych zwrócona przez zapytanie. Nie można go modyfikować.