Trip and Order Progress

FleetEngineTripLocationProvider class

google.maps.journeySharing.FleetEngineTripLocationProvider class

行程位置資訊提供者。

這個類別會擴充 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)。此外，無論對應這個標記的資料是否已變更，當位置資訊供應器從 Fleet Engine 接收資料時，系統都會呼叫這個函式。

    如要查看提供的參數及其用途清單，請參閱 TripMarkerCustomizationFunctionParams。
originMarkerCustomization optional
類型：  (function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
套用至起點標記的自訂項目。

使用這個欄位指定自訂樣式 (例如標記圖示) 和互動性 (例如點擊處理)。
  • 如果指定 MarkerOptions 物件，系統會在建立標記後，將其中指定的變更套用至標記，並覆寫預設選項 (如有)。
  • 如果指定函式，系統會在建立標記時呼叫該函式一次，然後將標記加入地圖檢視區塊。(在此呼叫中，函式參數物件中的 isNew 參數會設為 true)。此外，無論對應這個標記的資料是否已變更，當位置資訊供應器從 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)。此外，無論對應這個標記的資料是否已變更，當位置資訊供應器從 Fleet Engine 接收資料時，系統都會呼叫這個函式。

    如要查看提供的參數及其用途清單，請參閱 TripMarkerCustomizationFunctionParams。
waypointMarkerCustomization optional
類型：  (function(TripWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional
已套用至中途點標記的自訂項目。

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

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

FleetEngineTripLocationProviderUpdateEvent 介面

google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent 介面

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