Trip and Order Progress

Klasa FleetEngineTripLocationProvider

google.maps.journeySharing.FleetEngineTripLocationProvider zajęcia

Dostawca informacji o miejscu podróży.

Te zajęcia są rozszerzone na PollingLocationProvider.

Aby uzyskać dostęp, zadzwoń pod numer const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
Parametry: 
Tworzy nowego dostawcę lokalizacji dla podróży Fleet Engine.
tripId
Typ:  string
Identyfikator podróży obserwowany przez dostawcę lokalizacji. Ustaw to pole, aby rozpocząć śledzenie.
Odziedziczone: isPolling, pollingIntervalMillis
refresh
refresh()
Parametry: brak
Wartość zwrotu:  void
Wyraźnie odświeża śledzoną lokalizację.
Odziedziczone: 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.
Odziedziczone: ispollingchange

Interfejs FleetEngineTripLocationProviderOptions

google.maps.journeySharing.FleetEngineTripLocationProviderOptions interfejs

Opcje dostawcy lokalizacji podróży.
authTokenFetcher
Udostępnia tokeny sieciowe JSON do uwierzytelniania klienta we Fleet Engine.
projectId
Typ:  string
Identyfikator projektu konsumenta z konsoli Google Cloud.
destinationMarkerCustomization optional
Typ:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
Dostosowanie do znacznika miejsca docelowego zostało zastosowane.

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

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 TripMarkerCustomizationFunctionParams.
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.
tripId optional
Typ:  string optional
Identyfikator podróży do monitorowania natychmiast po utworzeniu instancji dostawcy lokalizacji. Jeśli go nie podasz, dostawca lokalizacji nie rozpocznie śledzenia podróży. Użyj FleetEngineTripLocationProvider.tripId, by ustawić identyfikator i rozpocząć śledzenie.
vehicleMarkerCustomization optional
Typ:  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions 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 TripMarkerCustomizationFunctionParams.
waypointMarkerCustomization optional
Dostosowanie do znacznika punktu pośredniego zostało zastosowane.

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

Interfejs FleetEngineTripLocationProviderUpdateEvent

google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent interfejs

Obiekt zdarzenia przekazywany do modułu obsługi zdarzeń po wywołaniu zdarzenia FleetEngineTripLocationProvider.update.
trip optional
Typ:  Trip optional
Struktura podróży zwrócona przez aktualizację. Nie można zmienić.