Trip and Order Progress

FleetEngineTripLocationProvider 類別

google.maps.journeySharing.FleetEngineTripLocationProvider 類別

行程地點供應商。

此類別會擴充 PollingLocationProvider。

使用 &libraries=journeySharing 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。

使用 v=beta 時，可透過呼叫 const {FleetEngineTripLocationProvider} = await google.map.importLibrary("journeySharing") 來存取請參閱 Maps JavaScript API 中的程式庫。
FleetEngineTripLocationProvider
FleetEngineTripLocationProvider(options)
參數：
為 Fleet Engine 行程建立新的位置提供者。
tripId
類型：string
這個位置提供者觀察到的行程 ID。設定這個欄位即可開始追蹤。
繼承： isPolling
refresh
refresh()
參數：無
傳回值：void
明確重新整理追蹤的地點。
繼承： addListener
error
function(event)
引數：
當位置提供者引發錯誤時觸發的事件。
update
function(event)
引數：
Fleet Engine 資料更新要求完成時觸發的事件。
繼承： ispollingchange

FleetEngineTripLocationProviderOptions 介面

google.maps.journeySharing.FleetEngineTripLocationProviderOptions 介面

行程地點供應商的選項。
authTokenFetcher
提供 JSON Web Token，用於驗證用戶端到 Fleet Engine。
projectId
類型：string
Google Cloud Console 中的消費者專案 ID。
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。
tripId optional
類型：string optional
地點提供者執行個體化後立即追蹤的行程 ID。如未指定，位置提供者不會開始追蹤任何行程；請使用 FleetEngineTripLocationProvider.tripId 設定 ID 並開始追蹤。
vehicleMarkerCustomization optional
類型：(function(TripMarkerCustomizationFunctionParams): void)|MarkerOptions optional
已對車輛標記套用自訂設定。

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

    如需提供的參數及其用途的清單，請參閱 TripMarkerCustomizationFunctionParams。
waypointMarkerCustomization optional
已對路線點標記套用自訂設定。

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

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

FleetEngineTripLocationProviderUpdateEvent 介面

google.maps.journeySharing.FleetEngineTripLocationProviderUpdateEvent 介面

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