Fleet Tracking - On Demand Rides & Delivery (beta)

Klasa FleetEngineVehicleLocationProvider

google.maps.journeySharing.FleetEngineVehicleLocationProvider zajęcia

Dostawca usług lokalizacji pojazdu.

Te zajęcia są rozszerzone na PollingLocationProvider.

Aby uzyskać dostęp, zadzwoń pod numer const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę lokalizacji dla pojazdu Fleet Engine.
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.
vehicleId
Typ:  string
Identyfikator pojazdu obserwowany przez tego dostawcę lokalizacji. Ustaw to pole, aby śledzić pojazd.
Odziedziczone: isPolling, pollingIntervalMillis
Odziedziczone: addListener
error
function(event)
Argumenty: 
Zdarzenie wywoływane, gdy dostawca lokalizacji napotka błąd.
update
function(event)
Zdarzenie wywoływane po zakończeniu żądania aktualizacji danych Fleet Engine.
Odziedziczone: ispollingchange

Interfejs FleetEngineVehicleLocationProviderOptions

google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions interfejs

Opcje dostawcy lokalizacji pojazdu.

authTokenFetcher
Udostępnia tokeny sieciowe JSON do uwierzytelniania klienta we Fleet Engine.
projectId
Typ:  string
Identyfikator projektu konsumenta z konsoli Google Cloud.
destinationMarkerCustomization optional
Dostosowanie do znacznika celu podróży pojazdu.

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

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 VehicleWaypointMarkerCustomizationFunctionParams.
originMarkerCustomization optional
Dostosowanie do znacznika miejsca rozpoczęcia podróży pojazdu.

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 VehicleWaypointMarkerCustomizationFunctionParams.
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.
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.
vehicleId optional
Typ:  string optional
Identyfikator pojazdu do śledzenia natychmiast po utworzeniu instancji dostawcy lokalizacji. Jeśli go nie podasz, dostawca lokalizacji nie rozpocznie śledzenia żadnego pojazdu. Użyj FleetEngineVehicleLocationProvider.vehicleId, aby ustawić identyfikator i rozpocząć śledzenie.
vehicleMarkerCustomization optional
Dostosowanie do znacznika pojazdu.

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

Interfejs FleetEngineVehicleLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent interfejs

Obiekt zdarzenia przekazywany do modułu obsługi zdarzeń po wywołaniu zdarzenia FleetEngineVehicleLocationProvider.update.

trips optional
Typ:  Array<Trip> optional
Lista podróży zrealizowanych przez ten pojazd. Nie można zmienić.
vehicle optional
Typ:  Vehicle optional
Struktura danych pojazdu zwrócona w ramach aktualizacji. Nie można zmienić.

Klasa FleetEngineFleetLocationProvider

google.maps.journeySharing.FleetEngineFleetLocationProvider zajęcia

Dostawca lokalizacji floty.

Te zajęcia są rozszerzone na PollingLocationProvider.

Aby uzyskać dostęp, zadzwoń pod numer const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę lokalizacji dla pojazdów śledzonych przez Fleet Engine.
locationRestriction
Granice, w których można śledzić pojazdy. Jeśli nie ustawiono granic, żadne pojazdy nie będą śledzone. Aby śledzić wszystkie pojazdy 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.
vehicleFilter
Typ:  string optional
Filtr stosowany podczas pobierania pojazdów.
Odziedziczone: isPolling, pollingIntervalMillis
Odziedziczone: addListener
update
function(event)
Zdarzenie wywoływane po zakończeniu żądania aktualizacji danych Fleet Engine.
Odziedziczone: ispollingchange

Interfejs FleetEngineFleetLocationProviderOptions

google.maps.journeySharing.FleetEngineFleetLocationProviderOptions interfejs

Opcje dostawcy lokalizacji floty.

authTokenFetcher
Udostępnia tokeny sieciowe JSON do uwierzytelniania klienta we Fleet Engine.
projectId
Typ:  string
Identyfikator projektu konsumenta z konsoli Google Cloud.
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 FleetEngineFleetLocationProvider.locationRestriction. Aby śledzić wszystkie pojazdy 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.
vehicleFilter optional
Typ:  string optional
Zapytanie filtra do zastosowania przy pobieraniu pojazdów. Ten filtr jest przekazywany bezpośrednio do Fleet Engine.

Obsługiwane formaty znajdziesz w ListVehiclesRequest.filter.

Pamiętaj, że prawidłowe filtry atrybutów muszą mieć prefiks „attributes”. np. 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ć 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 VehicleMarkerCustomizationFunctionParams.

Interfejs FleetEngineFleetLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent interfejs

Obiekt zdarzenia przekazywany do modułu obsługi zdarzeń po wywołaniu zdarzenia FleetEngineFleetLocationProvider.update.

vehicles optional
Typ:  Array<Vehicle> optional
Lista pojazdów zwróconych w odpowiedzi na zapytanie. Nie można zmienić.