Trip and Order Progress

Klasa FleetEngineTripLocationProvider

google.maps.journeySharing.FleetEngineTripLocationProvider class

dostawca lokalizacji podróży;

Te zajęcia trwają PollingLocationProvider.

Dostęp przez połączenie telefoniczne const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w Maps JavaScript API.
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę lokalizacji dla przejazdu w Fleet Engine.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
Parametry: 
Zwracana wartość:  brak
Funkcja dostosowywania wielokąta, która nadaje kolor aktywnemu wielokątowi zgodnie z wartością odczytu szybkości. Określ tę funkcję jako FleetEngineTripLocationProviderOptions.activePolylineCustomization, aby renderować linię łamaną uwzględniającą ruch dla 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 nadaje kolor pozostałym liniom łamanym zgodnie z ich odczytem prędkości. Określ tę funkcję jako FleetEngineTripLocationProviderOptions.remainingPolylineCustomization, aby renderować linię łamaną uwzględniającą natężenie ruchu dla pozostałej linii łamanej.
tripId
Typ:  string
Identyfikator podróży obserwowanej przez tego dostawcę lokalizacji. Aby rozpocząć śledzenie, ustaw to pole.
Uzyskane: isPolling, pollingIntervalMillis
refresh
refresh()
Parametry: brak
Wartość zwracana:  void
wyraźnie odświeża śledzoną lokalizację;
Podane z poziomu klasy: addListener
error
function(event)
Argumenty: 
Zdarzenie, które jest wywoływane, gdy dostawca lokalizacji napotka błąd.
update
function(event)
Argumenty: 
Zdarzenie, które jest wywoływane po zakończeniu przetwarzania żądania aktualizacji danych silnika floty.
Podane z poziomu klasy: 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 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 TripPolylineCustomizationFunctionParams.
destinationMarkerCustomization optional
Typ:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Dostosowywanie 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 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 TripMarkerCustomizationFunctionParams.
originMarkerCustomization optional
Typ:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Dostosowywanie 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 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 TripMarkerCustomizationFunctionParams.
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 TripPolylineCustomizationFunctionParams.
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 TripPolylineCustomizationFunctionParams.
tripId optional
Typ:  string optional
Identyfikator podróży do śledzenia bezpośrednio po utworzeniu dostawcy lokalizacji. Jeśli nie jest określony, dostawca lokalizacji nie rozpoczyna śledzenia żadnej podróży. Aby ustawić identyfikator i rozpocząć śledzenie, użyj FleetEngineTripLocationProvider.tripId.
vehicleMarkerCustomization optional
Typ:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Dostosowywanie zastosowane do znacznika pojazdu.

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 TripMarkerCustomizationFunctionParams.
waypointMarkerCustomization optional
Dostosowywanie zastosowane do znacznika punktu orientacyjnego.

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

Interfejs FleetEngineTripLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEventinterfejs

Obiekt zdarzenia przekazany do modułu obsługi zdarzenia, gdy zostanie wywołane zdarzenie FleetEngineTripLocationProvider.update.
trip optional
Typ:  Trip optional
Struktura podróży zwrócona przez aktualizację. Nie można ich modyfikować.