Trip and Order Progress

FleetEngineTripLocationProvider 類別

google.maps.journeySharing.FleetEngineTripLocationProvider 類別

行程地點提供者。

這個類別會擴充 PollingLocationProvider。

呼叫 const {FleetEngineTripLocationProvider} = await google.maps.importLibrary("journeySharing") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
參數： 
為 Fleet Engine 行程建立新的位置提供者。
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
參數： 
傳回值：無
折線自訂函式會根據計算速度的讀數，在啟用中的折線上色。將這個函式指定為 FleetEngineTripLocationProviderOptions.activePolylineCustomization，即可為啟用中的折線算繪交通感知折線。
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
參數： 
傳回值：無
折線自訂功能，可根據讀數顯示其餘折線的顏色。將此函式指定為 FleetEngineTripLocationProviderOptions.remainingPolylineCustomization，為其餘折線算繪交通感知折線。
tripId
類型：  string
此地點供應商觀測的行程 ID。設定這個欄位以開始追蹤。
沿用： isPolling、pollingIntervalMillis
refresh
refresh()
參數：無
傳回值：  void
明確重新整理追蹤的位置。
沿用： addListener
error
function(event)
引數： 
位置提供者發生錯誤時觸發的事件。
update
function(event)
引數： 
完成 Fleet Engine 資料更新要求時觸發的事件。
沿用： ispollingchange

FleetEngineTripLocationProviderOptions 介面

google.maps.journeySharing.FleetEngineTripLocationProviderOptions 介面

行程地點提供者的選項。
authTokenFetcher
類型：  AuthTokenFetcher
提供 JSON Web Token，向 Fleet Engine 驗證用戶端。
projectId
類型：  string
Google Cloud 控制台中的消費者專案 ID。
activePolylineCustomization optional
類型：  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
自訂套用至使用中的折線。有效的折線會對應車輛目前穿越的路線的一部分。

請使用這個欄位指定自訂樣式 (例如折線顏色) 和互動功能 (例如點擊處理)。
  • 如果指定 PolylineOptions 物件，則其中指定的變更會在建立折線後套用至折線，如果有，則會覆寫其預設選項。
  • 如果指定了一個函式，則會在建立折線時叫用一次。(在此叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當折線的座標有所變更，或位置提供者從 Fleet Engine 接收資料時，無論折線的對應資料是否有所變更，此函式都會叫用此函式。

    如需提供的參數清單及其用途清單，請參閱 TripPolylineCustomizationFunctionParams。
destinationMarkerCustomization optional
類型：  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
自訂已套用至目的地標記。

請使用這個欄位指定自訂樣式 (例如標記圖示) 和互動功能 (例如點擊處理)。
  • 如果指定 MarkerOptions 物件，則標記中指定的變更會在標記建立後套用至標記，而如果標記存在，則會覆寫其預設選項。
  • 如果指定函式，系統會在建立標記時呼叫該函式一次，之後才會將其加入地圖檢視。(在此叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，無論此標記對應的資料是否有所變更，函式參數物件中的 isNew 參數都會在 Fleet Engine 接收資料時叫用。

    如需提供的參數清單及其用途，請參閱 TripMarkerCustomizationFunctionParams。
originMarkerCustomization optional
類型：  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
自訂已套用至原始標記。

請使用這個欄位指定自訂樣式 (例如標記圖示) 和互動功能 (例如點擊處理)。
  • 如果指定 MarkerOptions 物件，則標記中指定的變更會在標記建立後套用至標記，而如果標記存在，則會覆寫其預設選項。
  • 如果指定函式，系統會在建立標記時呼叫該函式一次，之後才會將其加入地圖檢視。(在此叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，無論此標記對應的資料是否有所變更，函式參數物件中的 isNew 參數都會在 Fleet Engine 接收資料時叫用。

    如需提供的參數清單及其用途，請參閱 TripMarkerCustomizationFunctionParams。
pollingIntervalMillis optional
類型：  number optional
擷取位置更新作業之間的最短時間 (以毫秒為單位)。如果擷取位置資訊更新的時間超過 pollingIntervalMillis，則系統必須等到目前的位置更新作業完成後，才會啟動下一次位置更新作業。

如果將這個值設為 0，則會停用週期性位置更新功能。如果位置提供者觀察到的任何參數有所變更，系統會擷取新的位置更新通知。

預設的輪詢時間間隔為 5000 毫秒，即時間間隔下限。如果將輪詢時間間隔設為較低的非零值，系統就會使用 5000。
remainingPolylineCustomization optional
類型：  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
自訂套用至其餘折線。其餘的折線對應到車輛尚未開始週遊的部分路線。

請使用這個欄位指定自訂樣式 (例如折線顏色) 和互動功能 (例如點擊處理)。
  • 如果指定 PolylineOptions 物件，則其中指定的變更會在建立折線後套用至折線，如果有，則會覆寫其預設選項。
  • 如果指定了一個函式，則會在建立折線時叫用一次。(在此叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當折線的座標有所變更，或位置提供者從 Fleet Engine 接收資料時，無論折線的對應資料是否有所變更，此函式都會叫用此函式。

    如需提供的參數清單及其用途清單，請參閱 TripPolylineCustomizationFunctionParams。
takenPolylineCustomization optional
類型：  (function(TripPolylineCustomizationFunctionParams): void)|PolylineOptions optional
自訂套用至繪製折線的折線。行星的折線對應於車輛已行駛的路線部分。

請使用這個欄位指定自訂樣式 (例如折線顏色) 和互動功能 (例如點擊處理)。
  • 如果指定 PolylineOptions 物件，則其中指定的變更會在建立折線後套用至折線，如果有，則會覆寫其預設選項。
  • 如果指定了一個函式，則會在建立折線時叫用一次。(在此叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當折線的座標有所變更，或位置提供者從 Fleet Engine 接收資料時，無論折線的對應資料是否有所變更，此函式都會叫用此函式。

    如需提供的參數清單及其用途清單，請參閱 TripPolylineCustomizationFunctionParams。
tripId optional
類型：  string optional
位置供應商執行個體化後，要立即追蹤的行程 ID。如未指定，位置供應商就不會開始追蹤任何行程；使用 FleetEngineTripLocationProvider.tripId 設定 ID 並開始追蹤。
vehicleMarkerCustomization optional
類型：  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
自訂已套用至車輛標記。

請使用這個欄位指定自訂樣式 (例如標記圖示) 和互動功能 (例如點擊處理)。
  • 如果指定 MarkerOptions 物件，則標記中指定的變更會在標記建立後套用至標記，而如果標記存在，則會覆寫其預設選項。
  • 如果指定函式，系統會在建立標記時呼叫該函式一次，之後才會將其加入地圖檢視。(在此叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，無論此標記對應的資料是否有所變更，函式參數物件中的 isNew 參數都會在 Fleet Engine 接收資料時叫用。

    如需提供的參數清單及其用途，請參閱 TripMarkerCustomizationFunctionParams。
waypointMarkerCustomization optional
類型：  (function(TripWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional
自訂套用至路線控點標記。

請使用這個欄位指定自訂樣式 (例如標記圖示) 和互動功能 (例如點擊處理)。
  • 如果指定 MarkerOptions 物件，則標記中指定的變更會在標記建立後套用至標記，而如果標記存在，則會覆寫其預設選項。
  • 如果指定函式，系統會在建立標記時呼叫該函式一次，之後才會將其加入地圖檢視。(在此叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，無論此標記對應的資料是否有所變更，函式參數物件中的 isNew 參數都會在 Fleet Engine 接收資料時叫用。

    如需提供的參數清單及其用途，請參閱 TripWaypointMarkerCustomizationFunctionParams。

FleetEngineTripLocationProviderUpdateEvent 介面

google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent 介面

觸發 FleetEngineTripLocationProvider.update 事件時，傳遞至事件處理常式的事件物件。
trip optional
類型：  Trip optional
更新傳回的行程結構。無法修改。