Fleet Tracking - On Demand Rides & Delivery

FleetEngineVehicleLocationProvider class

google.maps.journeySharing.FleetEngineVehicleLocationProvider zajęcia

Dostawca lokalizacji pojazdu.

Ta klasa rozszerza klasę PollingLocationProvider.

Dostęp przez połączenie pod numer const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing").
 Zobacz Biblioteki w Maps JavaScript API.
FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę lokalizacji dla pojazdu 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 FleetEngineVehicleLocationProviderOptions.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 FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization, aby wyrenderować linię łamaną uwzględniającą ruch na pozostałej części linii łamanej.
staleLocationThresholdMillis
Typ:  number
To pole jest tylko do odczytu. Próg dla nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza niż ta wartość progowa, pojazd nie będzie wyświetlany.
vehicleId
Typ:  string
Identyfikator pojazdu, który obserwuje ten dostawca lokalizacji. Ustaw to pole, aby śledzić pojazd.
Przejęte: 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 FleetEngineVehicleLocationProviderOptions

google.maps.journeySharing.FleetEngineVehicleLocationProviderOptionsinterfejs

Opcje dostawcy lokalizacji pojazdu.
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 VehiclePolylineCustomizationFunctionParams.
destinationMarkerCustomization optional
Dostosowanie zastosowane do znacznika miejsca docelowego podróży pojazdem.

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 VehicleWaypointMarkerCustomizationFunctionParams.
intermediateDestinationMarkerCustomization optional
Dostosowanie zastosowane do znaczników pośrednich miejsc docelowych podróży pojazdem.

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 VehicleWaypointMarkerCustomizationFunctionParams.
originMarkerCustomization optional
Dostosowanie zastosowane do znacznika punktu początkowego podróży pojazdem.

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 VehicleWaypointMarkerCustomizationFunctionParams.
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 VehiclePolylineCustomizationFunctionParams.
staleLocationThresholdMillis optional
Typ:  number optional
Próg dla nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza niż ta wartość progowa, pojazd nie będzie wyświetlany. Domyślna wartość to 24 godziny w milisekundach. Jeśli wartość progowa jest mniejsza niż 0 lub nieskończoność, zostanie zignorowana, a lokalizacja pojazdu nie będzie uznawana za nieaktualną.
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 VehiclePolylineCustomizationFunctionParams.
vehicleId optional
Typ:  string optional
Identyfikator pojazdu do śledzenia natychmiast po utworzeniu instancji dostawcy lokalizacji. Jeśli nie zostanie określony, dostawca lokalizacji nie rozpocznie śledzenia żadnego pojazdu. Aby ustawić identyfikator i rozpocząć śledzenie, użyj FleetEngineVehicleLocationProvider.vehicleId.
vehicleMarkerCustomization 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 VehicleMarkerCustomizationFunctionParams.

FleetEngineVehicleLocationProviderUpdateEvent interfejs

google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEventinterfejs

Obiekt zdarzenia przekazywany do funkcji obsługi zdarzeń, gdy wywoływane jest zdarzenie FleetEngineVehicleLocationProvider.update.
trips optional
Typ:  Array<Trip> optional
Lista przejazdów zrealizowanych tym pojazdem. Nie można go modyfikować.
vehicle optional
Typ:  Vehicle optional
Struktura danych pojazdu zwrócona przez aktualizację. Nie można go modyfikować.

FleetEngineFleetLocationProvider class

google.maps.journeySharing.FleetEngineFleetLocationProvider zajęcia

Dostawca lokalizacji floty.

Ta klasa rozszerza klasę PollingLocationProvider.

Dostęp przez połączenie pod numer const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing").
 Zobacz Biblioteki w Maps JavaScript API.
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę lokalizacji dla pojazdów śledzonych przez Fleet Engine.
locationRestriction
Granice, w których mają być śledzone pojazdy. Jeśli nie ustawisz żadnych granic, żadne pojazdy nie będą śledzone. Aby śledzić wszystkie pojazdy niezależnie od lokalizacji, ustaw granice obejmujące całą 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ż ta wartość progowa, pojazd nie będzie wyświetlany.
vehicleFilter
Typ:  string optional
Filtr zastosowany podczas pobierania pojazdów.
Przejęte: isPolling, pollingIntervalMillis
Dziedziczone: addListener
update
function(event)
Argumenty: 
Zdarzenie wywoływane po zakończeniu żądania aktualizacji danych Fleet Engine.
Dziedziczone: ispollingchange

FleetEngineFleetLocationProviderOptions interfejs

google.maps.journeySharing.FleetEngineFleetLocationProviderOptionsinterfejs

Opcje dostawcy lokalizacji floty.
authTokenFetcher
Udostępnia tokeny sieciowe JSON do uwierzytelniania klienta w Fleet Engine.
projectId
Typ:  string
Identyfikator projektu konsumenta z Google Cloud Console.
locationRestriction optional
Granice szerokości i długości geograficznej, w których należy śledzić pojazdy natychmiast po utworzeniu instancji dostawcy lokalizacji. Jeśli nie zostanie ustawiony, dostawca lokalizacji nie rozpocznie śledzenia żadnych pojazdów. Aby ustawić granice i rozpocząć śledzenie, użyj FleetEngineFleetLocationProvider.locationRestriction. Aby śledzić wszystkie pojazdy niezależnie od lokalizacji, ustaw granice obejmujące całą Ziemię.
staleLocationThresholdMillis optional
Typ:  number optional
Próg dla nieaktualnej lokalizacji pojazdu. Jeśli ostatnia zaktualizowana lokalizacja pojazdu jest starsza niż ta wartość progowa, pojazd nie będzie wyświetlany. Domyślna wartość to 24 godziny w milisekundach. Jeśli wartość progowa jest mniejsza od zera lub wynosi nieskończoność, zostanie zignorowana, a lokalizacja pojazdu nie będzie uznawana za nieaktualną.
vehicleFilter optional
Typ:  string optional
Zapytanie filtra do zastosowania podczas pobierania pojazdów. Ten filtr jest przekazywany bezpośrednio do Fleet Engine.

Obsługiwane formaty znajdziesz w sekcji ListVehiclesRequest.filter.

Pamiętaj, że prawidłowe filtry atrybutów muszą mieć prefiks „attributes”. Na przykład attributes.x = "y" lub attributes."x y" = "z".
vehicleMarkerCustomization optional
Typ:  function(VehicleMarkerCustomizationFunctionParams): void 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 VehicleMarkerCustomizationFunctionParams.

FleetEngineFleetLocationProviderUpdateEvent interfejs

google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEventinterfejs

Obiekt zdarzenia przekazywany do funkcji obsługi zdarzeń, gdy wywoływane jest zdarzenie FleetEngineFleetLocationProvider.update.
vehicles optional
Typ:  Array<Vehicle> optional
Lista pojazdów zwróconych przez zapytanie. Nie można go modyfikować.