Trip and Order Progress

FleetEngineTripLocationProvider class

google.maps.journeySharing.FleetEngineTripLocationProvider zajęcia

Dostawca lokalizacji przejazdu.

Ta klasa rozszerza klasę PollingLocationProvider.

Dostęp przez połączenie pod numer const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing").
 Zobacz Biblioteki w Maps JavaScript API.
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę lokalizacji na potrzeby przejazdu w Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parametry: 
Zwracana wartość: brak
Funkcja dostosowywania polilinii, która koloruje aktywną polilinię zgodnie z odczytem prędkości. Określ tę funkcję jako FleetEngineTripLocationProviderOptions.activePolylineCustomization, aby renderować linię łamaną uwzględniającą ruch w przypadku aktywnej linii łamanej.
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parametry: 
Zwracana wartość: brak
Funkcja dostosowywania linii łamanej, która koloruje pozostałą część linii łamanej zgodnie z odczytem prędkości. Określ tę funkcję jako FleetEngineTripLocationProviderOptions.remainingPolylineCustomization, aby wyrenderować linię łamaną uwzględniającą ruch na pozostałej części linii łamanej.
tripId
Typ:  string
Identyfikator podróży, którą obserwuje ten dostawca lokalizacji. Ustaw to pole, aby rozpocząć śledzenie.
Przejęte: isPolling, pollingIntervalMillis
refresh
refresh()
Parametry: brak
Zwracana wartość:  void
Wyraźnie odświeża śledzoną lokalizację.
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 FleetEngineTripLocationProviderOptions

google.maps.journeySharing.FleetEngineTripLocationProviderOptionsinterfejs

Opcje dostawcy lokalizacji podróży.
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 TripPolylineCustomizationFunctionParams.
destinationMarkerCustomization optional
Typ:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Dostosowanie zastosowane do znacznika miejsca docelowego.

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 TripMarkerCustomizationFunctionParams.
originMarkerCustomization optional
Typ:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Dostosowanie zastosowane do znacznika punktu początkowego.

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 TripMarkerCustomizationFunctionParams.
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 TripPolylineCustomizationFunctionParams.
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 TripPolylineCustomizationFunctionParams.
tripId optional
Typ:  string optional
Identyfikator przejazdu, który ma być śledzony natychmiast po utworzeniu instancji dostawcy lokalizacji. Jeśli nie zostanie określony, dostawca lokalizacji nie rozpocznie śledzenia żadnej podróży. Aby ustawić identyfikator i rozpocząć śledzenie, użyj FleetEngineTripLocationProvider.tripId.
vehicleMarkerCustomization optional
Typ:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Dostosowanie zastosowane do znacznika pojazdu.

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 TripMarkerCustomizationFunctionParams.
waypointMarkerCustomization optional
Dostosowanie zastosowane do znacznika punktu pośredniego.

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 TripWaypointMarkerCustomizationFunctionParams.

FleetEngineTripLocationProviderUpdateEvent interfejs

google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEventinterfejs

Obiekt zdarzenia przekazywany do funkcji obsługi zdarzeń, gdy wywoływane jest zdarzenie FleetEngineTripLocationProvider.update.
trip optional
Typ:  Trip optional
Struktura podróży zwracana przez aktualizację. Nie można go modyfikować.