Fleet Tracking - Last Mile Fleet

klasa FleetEngineDeliveryVehicleLocationProvider

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider class

Dostawca lokalizacji pojazdu dostawczego.

Te zajęcia trwają PollingLocationProvider.

Dostęp przez połączenie telefoniczne 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 obserwowanego przez tego dostawcę 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 pobrane zadania.
staleLocationThresholdMillis
Typ:  number
To pole jest tylko do odczytu. Próg dla 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ą być stosowane podczas pobierania zadań.
Uzyskane: isPolling, pollingIntervalMillis
Podane z poziomu klasy: addListener
error
function(event)
Argumenty: 
Zdarzenie, które jest wywoływane, gdy dostawca lokalizacji napotka błąd.
update
function(event)
Zdarzenie, które jest wywoływane po zakończeniu przetwarzania żądania aktualizacji danych silnika floty.
Podane z poziomu klasy: ispollingchange

Interfejs FleetEngineDeliveryVehicleLocationProviderOptions

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptionsinterfejs

Opcje dostawcy lokalizacji pojazdu.

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 DeliveryVehiclePolylineCustomizationFunctionParams.
deliveryVehicleId optional
Typ:  string optional
Identyfikator pojazdu dostawczego do śledzenia, który jest tworzony natychmiast po uruchomieniu 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
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 DeliveryVehicleMarkerCustomizationFunctionParams.
plannedStopMarkerCustomization optional
Dostosowywanie zastosowane do zaplanowanego punktu zatrzymania.

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 PlannedStopMarkerCustomizationFunctionParams.
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 spowoduje wyłączenie powtarzających się aktualizacji lokalizacji. Nowe dane o lokalizacji są pobierane, jeśli zmieni się którykolwiek z parametrów obserwowanych przez dostawcę lokalizacji.

Domyślny interwał sondowania to 5000 milisekund, czyli minimalny interwał. Jeśli ustawisz interwał sprawdzania na mniejszą wartość niezerową, zostanie 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 DeliveryVehiclePolylineCustomizationFunctionParams.
shouldShowOutcomeLocations optional
Typ:  boolean optional
Wartość logiczna określająca, czy pobrane zadania mają wyświetlać lub ukrywać miejsca docelowe.
shouldShowTasks optional
Typ:  boolean optional
Wartość logiczna określająca, czy zadania mają być wyświetlane, czy ukryte. Ustawienie tej opcji na wartość fałsz spowoduje, że nie będzie wywoływany punkt końcowy ListTasks w celu pobierania zadań. Wyświetlane będą tylko nadchodzące przystanki pojazdu.
staleLocationThresholdMillis optional
Typ:  number optional
Próg dla nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza od tego progu, pojazd nie będzie wyświetlany. Wartość domyślna to 24 godziny w milisekundach. Jeśli próg jest mniejszy niż 0 lub Nieskończoność, zostanie zignorowany, a lokalizacja pojazdu nie zostanie uznana za nieaktualną.
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 DeliveryVehiclePolylineCustomizationFunctionParams.
taskFilterOptions optional
Opcje filtrowania do stosowania podczas pobierania zadań. Opcje mogą obejmować konkretny pojazd, czas i stan zadania.
taskMarkerCustomization optional
Typ:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Dostosowywanie 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ć 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 TaskMarkerCustomizationFunctionParams.
taskOutcomeMarkerCustomization optional
Typ:  function(TaskMarkerCustomizationFunctionParams): void optional
Dostosowywanie zastosowane do znacznika wyniku zadania. Oznakowanie wyniku zadania jest renderowane 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 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 TaskMarkerCustomizationFunctionParams.

Interfejs FleetEngineTaskFilterOptions

google.maps.journeySharing.FleetEngineTaskFilterOptionsinterfejs

Opcje filtrowania zadań w usługach dostawy pojazdu.

completionTimeFrom optional
Typ:  Date optional
Wyłączna dolna granica czasu ukończenia zadania. Służy do filtrowania zadań, które zostały ukończone po określonym czasie.
completionTimeTo optional
Typ:  Date optional
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 (otwarte) lub CLOSED (zamknięte).

Interfejs FleetEngineDeliveryVehicleLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEventinterfejs

Obiekt zdarzenia przekazany do modułu obsługi zdarzenia, gdy zostanie wywołane zdarzenie FleetEngineDeliveryVehicleLocationProvider.update.

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

klasa FleetEngineDeliveryFleetLocationProvider

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider class

Dostawca lokalizacji floty.

Te zajęcia trwają PollingLocationProvider.

Dostęp przez połączenie telefoniczne 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 silnik floty.
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 żadnych ograniczeń, nie będzie śledzonych żadnych pojazdów dostawczych. Aby śledzić wszystkie pojazdy dostawcze niezależnie od lokalizacji, ustaw granice odpowiadające całej 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ż ten próg, pojazd nie będzie wyświetlany.
Uzyskane: isPolling, pollingIntervalMillis
Podane z poziomu klasy: addListener
update
function(event)
Zdarzenie, które jest wywoływane po zakończeniu przetwarzania żądania aktualizacji danych silnika floty.
Podane z poziomu klasy: 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 konsoli Google Cloud.
deliveryVehicleFilter optional
Typ:  string optional
Zapytanie filtra stosowane podczas pobierania pojazdów dostawczych. Ten filtr jest przekazywany bezpośrednio do mechanizmu Fleet.

Zobacz obsługiwane formaty w 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
Dostosowywanie 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 DeliveryVehicleMarkerCustomizationFunctionParams.
locationRestriction optional
Granice szerokości i długości geograficznej, w których mają być śledzone pojazdy, natychmiast po utworzeniu dostawcy lokalizacji. Jeśli nie zostanie ustawiona, dostawca lokalizacji nie rozpocznie śledzenia żadnych pojazdów. Aby ustawić granice i rozpocząć śledzenie, użyj opcji FleetEngineDeliveryFleetLocationProvider.locationRestriction. Aby śledzić wszystkie pojazdy dostawcze niezależnie od lokalizacji, ustaw granice odpowiadające całej Ziemi.
staleLocationThresholdMillis optional
Typ:  number optional
Próg dla nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza od tego progu, pojazd nie będzie wyświetlany. Wartość domyślna to 24 godziny w milisekundach. Jeśli próg jest mniejszy niż 0 lub równy , zostanie zignorowany, a lokalizacja pojazdu nie zostanie uznana za stałą.

Interfejs FleetEngineDeliveryFleetLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEventinterfejs

Obiekt zdarzenia przekazany do modułu obsługi zdarzenia, gdy zostanie wywołane zdarzenie FleetEngineDeliveryFleetLocationProvider.update.

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