Fleet Tracking - Last Mile Fleet

Klasa FleetEngineDeliveryVehicleLocationProvider

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

Dostawca lokalizacji pojazdu dostawczego.

const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");
FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
Parametry:
Tworzy nowego dostawcę lokalizacji dla pojazdu dostawczego Fleet Engine.
deliveryVehicleId
Typ: string
Identyfikator pojazdu, który jest obserwowany przez tego dostawcę lokalizacji. Ustaw to pole, aby śledzić pojazd.
shouldShowOutcomeLocations
Typ: boolean optional
Opcjonalnie możesz zezwolić 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 nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza niż ten próg, pojazd nie będzie wyświetlany.
taskFilterOptions
Zwraca opcje filtrowania, które mają zostać zastosowane podczas pobierania zadań.
Dziedziczone: isPolling, pollingIntervalMillis
Dziedziczone: addListener
error
function(event)
Argumenty:
Zdarzenie wywoływane, gdy dostawca lokalizacji napotka błąd.
update
function(event)
Argumenty:
Zdarzenie wywoływane po zakończeniu żądania aktualizacji danych Fleet Engine.
Dziedziczone: ispollingchange

Interfejs FleetEngineDeliveryVehicleLocationProviderOptions

Interfejs google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions

Opcje dostawcy lokalizacji pojazdu dostawczego.
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 DeliveryVehiclePolylineCustomizationFunctionParams.
deliveryVehicleId
opcjonalne
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 zacznie śledzić żadnego pojazdu. Aby ustawić identyfikator i rozpocząć śledzenie, użyj FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId.
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 DeliveryVehicleMarkerCustomizationFunctionParams.
plannedStopMarkerCustomization
opcjonalne
Dostosowanie zastosowane do znacznika planowanego przystanku.

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 PlannedStopMarkerCustomizationFunctionParams.
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 wyłącza cykliczne aktualizacje lokalizacji. Nowa informacja o zmianie lokalizacji jest pobierana, gdy zmieni się którykolwiek z parametrów obserwowanych przez dostawcę lokalizacji.

Domyślny odstęp sondowania to 5000 milisekund, co jest wartością minimalną. Jeśli ustawisz interwał odpytywania na mniejszą wartość inną niż 0, zostanie 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 DeliveryVehiclePolylineCustomizationFunctionParams.
shouldShowOutcomeLocations
opcjonalne
Typ: boolean optional
Wartość logiczna określająca, czy wyświetlać lub ukrywać lokalizacje wyników pobranych zadań.
shouldShowTasks
opcjonalne
Typ: boolean optional
Wartość logiczna określająca, czy zadania mają być wyświetlane, czy ukryte. Jeśli ustawisz wartość false, punkt końcowy ListTasks nie będzie wywoływany w celu pobrania zadań. Wyświetlane będą tylko nadchodzące przystanki.
staleLocationThresholdMillis
opcjonalne
Typ: number optional
Próg nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza niż ten próg, pojazd nie będzie wyświetlany. Wartość domyślna to 24 godziny w milisekundach. Jeśli próg jest mniejszy niż 0 lub wynosi Infinity, zostanie zignorowany, a lokalizacja pojazdu nie będzie uznawana za nieaktualną.
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 DeliveryVehiclePolylineCustomizationFunctionParams.
taskFilterOptions
opcjonalne
Opcje filtrowania, które mają być stosowane podczas pobierania zadań. Opcje mogą obejmować konkretny pojazd, czas i stan zadania.
taskMarkerCustomization
opcjonalne
Dostosowanie zastosowane do znacznika zadania. Znacznik zadania jest renderowany w planowanej lokalizacji każdego zadania przypisanego do 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 TaskMarkerCustomizationFunctionParams.
taskOutcomeMarkerCustomization
opcjonalne
Typ: function(TaskMarkerCustomizationFunctionParams): void optional
Dostosowanie zastosowane do znacznika wyniku zadania. Znacznik wyniku zadania jest renderowany w miejscu rzeczywistego wyniku każdego zadania przypisanego do 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 TaskMarkerCustomizationFunctionParams.

Interfejs FleetEngineTaskFilterOptions

Interfejs google.maps.journeySharing.FleetEngineTaskFilterOptions

Opcje filtrowania zadań w usłudze dostawcy lokalizacji pojazdu dostawczego.
completionTimeFrom
opcjonalne
Typ: Date optional
Dolna granica czasu ukończenia zadania (wyłącznie). Służy do filtrowania zadań, które zostały ukończone po określonym czasie.
completionTimeTo
opcjonalne
Typ: Date optional
Wyłączne górne ograniczenie czasu ukończenia zadania. Służy do filtrowania zadań, które zostały ukończone przed określonym czasem.
state
opcjonalne
Typ: string optional
Stan zadania. Prawidłowe wartości to OPEN (otwarte) lub CLOSED (zamknięte).

Interfejs FleetEngineDeliveryVehicleLocationProviderUpdateEvent

Interfejs google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent

Obiekt zdarzenia przekazywany do modułu obsługi zdarzeń po wywołaniu zdarzenia FleetEngineDeliveryVehicleLocationProvider.update.
completedVehicleJourneySegments
opcjonalne
Odcinki podróży, które zostały pokonane przez ten pojazd. Nie można go modyfikować.
deliveryVehicle
opcjonalne
Typ: DeliveryVehicle optional
Struktura danych pojazdu dostawczego zwrócona przez aktualizację. Nie można go modyfikować.
tasks
opcjonalne
Typ: Array<Task> optional
Lista zadań obsługiwanych przez ten pojazd dostawczy. Nie można go modyfikować.

Klasa FleetEngineDeliveryFleetLocationProvider

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

Dostawca lokalizacji floty dostawczej.

const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing");
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 odpowiadające całej kuli ziemskiej.
staleLocationThresholdMillis
Typ: number
To pole jest tylko do odczytu. Próg nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza niż ten próg, pojazd nie będzie wyświetlany.
Dziedziczone: isPolling, pollingIntervalMillis
Dziedziczone: addListener
update
function(event)
Argumenty:
Zdarzenie wywoływane po zakończeniu żądania aktualizacji danych Fleet Engine.
Dziedziczone: ispollingchange

FleetEngineDeliveryFleetLocationProviderOptions interface

Interfejs google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions

Opcje dostawcy lokalizacji floty dostawczej.
authTokenFetcher
Udostępnia tokeny sieciowe JSON do uwierzytelniania klienta w Fleet Engine.
projectId
Typ: string
Identyfikator projektu klienta z konsoli Google Cloud.
deliveryVehicleFilter
opcjonalne
Typ: string optional
Zapytanie filtra, które ma zostać zastosowane 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
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 DeliveryVehicleMarkerCustomizationFunctionParams.
locationRestriction
opcjonalne
Granice szerokości i długości geograficznej, w których pojazdy mają być śledzone natychmiast po utworzeniu instancji dostawcy lokalizacji. Jeśli nie zostanie ustawiony, dostawca lokalizacji nie zacznie śledzić żadnych pojazdów. Aby ustawić granice i rozpocząć śledzenie, użyj FleetEngineDeliveryFleetLocationProvider.locationRestriction. Aby śledzić wszystkie pojazdy dostawcze niezależnie od lokalizacji, ustaw granice odpowiadające całej kuli ziemskiej.
staleLocationThresholdMillis
opcjonalne
Typ: number optional
Próg nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza niż ten próg, pojazd nie będzie wyświetlany. Wartość domyślna to 24 godziny w milisekundach. Jeśli próg jest mniejszy od zera lub wynosi Infinity, zostanie zignorowany, a lokalizacja pojazdu nie będzie uznawana za nieaktualną.

Interfejs FleetEngineDeliveryFleetLocationProviderUpdateEvent

Interfejs google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent

Obiekt zdarzenia przekazywany do modułu obsługi zdarzeń po wywołaniu zdarzenia FleetEngineDeliveryFleetLocationProvider.update.
deliveryVehicles
opcjonalne
Typ: Array<DeliveryVehicle> optional
Lista pojazdów dostawczych zwrócona przez zapytanie. Nie można go modyfikować.