Fleet Tracking - Last Mile Fleet

Klasa FleetEngineDeliveryVehicleLocationProvider

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider zajęcia

Dostawca usługi lokalizacji pojazdu dostawy.

Te zajęcia są rozszerzone na PollingLocationProvider.

Aby uzyskać dostęp, zadzwoń pod numer const {FleetEngineDeliveryVehicleLocationProvider} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę lokalizacji dla pojazdu dostarczającego Fleet Engine.
deliveryVehicleId
Typ:  string
Identyfikator pojazdu obserwowany 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
Możesz opcjonalnie zezwolić 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ą być stosowane przy pobieraniu zadań.
Odziedziczone: isPolling, pollingIntervalMillis
Odziedziczone: 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.
Odziedziczone: ispollingchange

Interfejs FleetEngineDeliveryVehicleLocationProviderOptions

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions interfejs

Opcje dostawcy lokalizacji pojazdu dostawczego.
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 DeliveryVehiclePolylineCustomizationFunctionParams.
deliveryVehicleId optional
Typ:  string optional
Identyfikator pojazdu dostawczego, który ma być śledzony natychmiast po utworzeniu instancji dostawcy lokalizacji. Jeśli go nie podasz, dostawca lokalizacji nie rozpocznie śledzenia żadnego pojazdu. Użyj FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId, aby ustawić identyfikator i rozpocząć śledzenie.
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 DeliveryVehicleMarkerCustomizationFunctionParams.
plannedStopMarkerCustomization optional
Dostosowanie zostało zastosowane do znacznika zaplanowanego zatrzymania.

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 PlannedStopMarkerCustomizationFunctionParams.
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 wyłącza cykliczne aktualizacje lokalizacji. Jeśli zmieni się którykolwiek z parametrów zaobserwowanych przez dostawcę lokalizacji, zostanie pobrana nowa aktualizacja lokalizacji.

Domyślny interwał sondowania to 5000 milisekund (minimalny odstęp czasu). Jeśli przedział odpytywania zostanie ustawiony na mniejszą wartość inną niż 0, zostanie użyta wartość 5000.
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 DeliveryVehiclePolylineCustomizationFunctionParams.
shouldShowOutcomeLocations optional
Typ:  boolean optional
Wartość logiczna służąca do pokazywania lub ukrywania lokalizacji wyników pobranych zadań.
shouldShowTasks optional
Typ:  boolean optional
Wartość logiczna służąca do pokazywania i ukrywania zadań. Jeśli zasada ma wartość Fałsz, punkt końcowy ListTasks nie może być wywoływany w celu pobrania zadań. Na liście wyświetlają się tylko zbliżające się przystanki pojazdów.
staleLocationThresholdMillis optional
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 wartość Nieskończoność, próg zostanie zignorowany, a lokalizacja pojazdu nie zostanie uznana za nieaktualna.
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 DeliveryVehiclePolylineCustomizationFunctionParams.
taskFilterOptions optional
Opcje filtrowania stosowane przy pobieraniu zadań. Dostępne opcje mogą obejmować konkretny pojazd, czas i stan zadania.
taskMarkerCustomization optional
Typ:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Dostosowanie zostało zastosowane do znacznika zadania. W planowanej lokalizacji każdego zadania przypisanego do pojazdu dostawczego wyświetlany jest znacznik zadania.

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 TaskMarkerCustomizationFunctionParams.
taskOutcomeMarkerCustomization optional
Typ:  function(TaskMarkerCustomizationFunctionParams): void optional
Dostosowanie zostało 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ś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 TaskMarkerCustomizationFunctionParams.

Interfejs FleetEngineTaskFilterOptions

google.maps.journeySharing.FleetEngineTaskFilterOptions interfejs

Opcje filtrowania zadań u dostawcy lokalizacji pojazdu dostarczającego.
completionTimeFrom optional
Typ:  Date optional
Dolna granica wyłącznego 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 wyłącznie dla 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.FleetEngineDeliveryVehicleLocationProviderUpdateEvent interfejs

Obiekt zdarzenia przekazywany do modułu obsługi zdarzeń po wywołaniu zdarzenia FleetEngineDeliveryVehicleLocationProvider.update.
completedVehicleJourneySegments optional
Typ:  Array<VehicleJourneySegment> optional
Segmenty podróży ukończone przez ten pojazd. Nie można zmienić.
deliveryVehicle optional
Typ:  DeliveryVehicle optional
Struktura danych pojazdu dostawczego zwrócona w ramach aktualizacji. Nie można zmienić.
tasks optional
Typ:  Array<Task> optional
Lista zadań obsługiwanych przez ten pojazd dostawczy. Nie można zmienić.

Klasa FleetEngineDeliveryFleetLocationProvider

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider zajęcia

Dostawca lokalizacji floty dostawy.

Te zajęcia są rozszerzone na PollingLocationProvider.

Aby uzyskać dostęp, zadzwoń pod numer const {FleetEngineDeliveryFleetLocationProvider} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę lokalizacji dla pojazdów śledzonych przez Fleet Engine.
deliveryVehicleFilter
Typ:  string optional
Filtr stosowany podczas pobierania pojazdów dostawczych.
locationRestriction
Granice, w których można śledzić pojazdy dostawcze. Jeśli nie ustawiono granic, żadne pojazdy dostawcze nie będą śledzone. Aby śledzić wszystkie pojazdy dostawcze niezależnie od lokalizacji, ustaw progi odpowiadające całej powierzchni Ziemi.
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.
Odziedziczone: isPolling, pollingIntervalMillis
Odziedziczone: addListener
update
function(event)
Argumenty: 
Zdarzenie wywoływane po zakończeniu żądania aktualizacji danych Fleet Engine.
Odziedziczone: ispollingchange

Interfejs FleetEngineDeliveryFleetLocationProviderOptions

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions interfejs

Opcje dostawcy lokalizacji floty dostarczania.
authTokenFetcher
Udostępnia tokeny sieciowe JSON do uwierzytelniania klienta we Fleet Engine.
projectId
Typ:  string
Identyfikator projektu konsumenta z konsoli Google Cloud.
deliveryVehicleFilter optional
Typ:  string optional
Zapytanie filtra do użycia przy pobieraniu pojazdów dostawczych. Ten filtr jest przekazywany bezpośrednio do Fleet Engine.

Obsługiwane formaty znajdziesz w ListDeliveryVehiclesRequest.filter.

Pamiętaj, że prawidłowe filtry atrybutów muszą mieć prefiks „attributes”. np. 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ć 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 DeliveryVehicleMarkerCustomizationFunctionParams.
locationRestriction optional
Zakresy szerokości i długości geograficznej, w których można śledzić pojazdy natychmiast po utworzeniu instancji dla dostawcy lokalizacji. Jeśli jej nie skonfigurujesz, dostawca lokalizacji nie zacznie śledzić żadnych pojazdów. Aby wyznaczyć granice i rozpocząć śledzenie, użyj FleetEngineDeliveryFleetLocationProvider.locationRestriction. Aby śledzić wszystkie pojazdy dostawcze niezależnie od lokalizacji, ustaw progi odpowiadające całej powierzchni Ziemi.
staleLocationThresholdMillis optional
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 wartość Nieskończoność, próg zostanie zignorowany, a lokalizacja pojazdu nie zostanie uznana za nieaktualna.

Interfejs FleetEngineDeliveryFleetLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent interfejs

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