Fleet Tracking - On Demand Rides & Delivery (beta)

klasa FleetEngineVehicleLocationProvider

google.maps.journeySharing.FleetEngineVehicleLocationProvider class

Dostawca lokalizacji pojazdu.

Te zajęcia trwają PollingLocationProvider.

Dostęp przez połączenie telefoniczne 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 wielokąta, która nadaje kolor aktywnemu wielokątowi zgodnie z wartością odczytu szybkości. Określ tę funkcję jako FleetEngineVehicleLocationProviderOptions.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 FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization, aby renderować linię łamaną uwzględniającą natężenie ruchu dla pozostałej 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ż ten próg, pojazd nie będzie wyświetlany.
vehicleId
Typ:  string
Identyfikator pojazdu obserwowanego przez tego dostawcę lokalizacji. Ustaw to pole, aby śledzić pojazd.
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)
Argumenty: 
Zdarzenie, które jest wywoływane po zakończeniu przetwarzania żądania aktualizacji danych silnika floty.
Podane z poziomu klasy: 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 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 VehiclePolylineCustomizationFunctionParams.
destinationMarkerCustomization optional
Dostosowywanie 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 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 VehicleWaypointMarkerCustomizationFunctionParams.
intermediateDestinationMarkerCustomization optional
Dostosowywanie zastosowane do znaczników pośrednich celu podróży 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 VehicleWaypointMarkerCustomizationFunctionParams.
originMarkerCustomization optional
Personalizacja zastosowana do znacznika punktu początkowego podróży.

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 VehicleWaypointMarkerCustomizationFunctionParams.
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 VehiclePolylineCustomizationFunctionParams.
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 VehiclePolylineCustomizationFunctionParams.
vehicleId optional
Typ:  string optional
Identyfikator pojazdu 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 FleetEngineVehicleLocationProvider.vehicleId.
vehicleMarkerCustomization 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 VehicleMarkerCustomizationFunctionParams.

FleetEngineVehicleLocationProviderUpdateEvent interfejs

google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEventinterfejs

Obiekt zdarzenia przekazany do modułu obsługi zdarzenia, gdy zostanie wywołane zdarzenie FleetEngineVehicleLocationProvider.update.
trips optional
Typ:  Array<Trip> optional
Lista przejazdów wykonanych przez ten pojazd. Nie można ich modyfikować.
vehicle optional
Typ:  Vehicle optional
Struktura danych pojazdu zwrócona przez aktualizację. Nie można ich modyfikować.

klasa FleetEngineFleetLocationProvider

google.maps.journeySharing.FleetEngineFleetLocationProvider class

Dostawca lokalizacji floty.

Te zajęcia trwają PollingLocationProvider.

Dostęp przez połączenie telefoniczne 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 silnik floty.
locationRestriction
Granice, w których mają być śledzone pojazdy. Jeśli nie ustawisz żadnych granic, nie będzie śledzonych żadnych pojazdów. Aby śledzić wszystkie pojazdy bez względu na lokalizację, 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.
vehicleFilter
Typ:  string optional
Filtr zastosowany podczas pobierania pojazdów.
Uzyskane: isPolling, pollingIntervalMillis
Podane z poziomu klasy: addListener
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 FleetEngineFleetLocationProviderOptions

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 konsoli Google Cloud.
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 FleetEngineFleetLocationProvider.locationRestriction. Aby śledzić wszystkie pojazdy bez względu na lokalizację, 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 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 równy ∞, zostanie zignorowany, a lokalizacja pojazdu nie zostanie uznana za stałą.
vehicleFilter optional
Typ:  string optional
Zapytanie filtra stosowane podczas pobierania pojazdów. Ten filtr jest przekazywany bezpośrednio do mechanizmu Fleet.

Zobacz obsługiwane formaty w 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
Personalizacja zastosowana 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 VehicleMarkerCustomizationFunctionParams.

FleetEngineFleetLocationProviderUpdateEvent interface

google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEventinterfejs

Obiekt zdarzenia przekazany do modułu obsługi zdarzenia, gdy zostanie wywołane zdarzenie FleetEngineFleetLocationProvider.update.
vehicles optional
Typ:  Array<Vehicle> optional
Lista pojazdów zwróconych przez zapytanie. Nie można ich modyfikować.