Shipment Tracking

FleetEngineShipmentLocationProvider 類別

google.maps.journeySharing.FleetEngineShipmentLocationProvider 類別

出貨地點供應商。

此類別會擴充 PollingLocationProvider

呼叫 const {FleetEngineShipmentLocationProvider} = await google.maps.importLibrary("journeySharing") 即可存取。請參閱 Maps JavaScript API 中的程式庫

FleetEngineShipmentLocationProvider
FleetEngineShipmentLocationProvider(options)
參數: 
建立新的 Fleet Engine 運送追蹤服務供應商。
trackingId
類型:  string
此位置提供者觀察到的工作追蹤 ID。設定這個欄位即可開始追蹤。
繼承: isPollingpollingIntervalMillis
refresh
refresh()
參數:
傳回值:  void
明確重新整理追蹤的地點。
繼承: addListener
error
function(event)
引數: 
當位置提供者引發錯誤時觸發的事件。
update
function(event)
Fleet Engine 資料更新要求完成時觸發的事件。
繼承: ispollingchange

FleetEngineShipmentLocationProviderOptions 介面

google.maps.journeySharing.FleetEngineShipmentLocationProviderOptions 介面

運送地點的供應商。

authTokenFetcher
類型:  AuthTokenFetcher
提供 JSON Web Token,用於驗證用戶端到 Fleet Engine。
projectId
類型:  string
Google Cloud Console 中的消費者專案 ID。
deliveryVehicleMarkerCustomization optional
類型:  (function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional
「客製化」標記已用於自訂。

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

    如需提供的參數及其用途的清單,請參閱 ShipmentMarkerCustomizationFunctionParams
destinationMarkerCustomization optional
類型:  (function(ShipmentMarkerCustomizationFunctionParams): void)|MarkerOptions optional
已對目的地標記套用自訂設定。

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

    如需提供的參數及其用途的清單,請參閱 ShipmentMarkerCustomizationFunctionParams
pollingIntervalMillis optional
類型:  number optional
擷取位置資訊更新的時間下限 (以毫秒為單位)。如果擷取位置更新的時間超過 pollingIntervalMillis,則系統會等到下一次更新作業完成,才會開始更新位置資訊。

如果將這個值設為 0、Infinity 或負值,系統就會停用自動更新位置功能。追蹤 ID 參數 (例如運送地點供應商的運送追蹤 ID) 或篩選選項 (例如可視區域位置的貨運公司邊界或屬性篩選器) 有所變更時,系統則會擷取一次新的位置更新。

預設和最小輪詢間隔為 5000 毫秒。如果將輪詢間隔設為較低的正數值,系統會儲存並使用 5000 個。
trackingId optional
類型:  string optional
在位置提供者執行個體化之後,立即追蹤的工作追蹤 ID。如未指定,位置提供者不會開始追蹤任何工作;請使用 FleetEngineShipmentLocationProvider.trackingId 設定追蹤 ID 並開始追蹤。

FleetEngineShipmentLocationProviderUpdateEvent 介面

google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent 介面

觸發 FleetEngineShipmentLocationProvider.update 事件時傳送至事件處理常式的事件物件。

taskTrackingInfo optional
類型:  TaskTrackingInfo optional
更新傳回的工作追蹤資訊結構。您無法修改。