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。設定這個欄位以開始追蹤。
沿用: isPollingpollingIntervalMillis
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
更新傳回的行程結構。無法修改。