Fleet Tracking - Last Mile Fleet

FleetEngineDeliveryVehicleLocationProvider 類別

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider 類別

運送車輛定位服務供應商。

這個類別會擴充 PollingLocationProvider

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

FleetEngineDeliveryVehicleLocationProvider
FleetEngineDeliveryVehicleLocationProvider(options)
參數: 
為 Fleet Engine 外送車輛建立新的定位服務供應商。
deliveryVehicleId
類型:  string
這個位置供應商觀察的車輛 ID。設定此欄位以追蹤車輛。
shouldShowOutcomeLocations
類型:  boolean optional
允許使用者顯示工作的結果位置。
shouldShowTasks
類型:  boolean optional
您可以視需要允許使用者顯示已擷取的工作。
staleLocationThresholdMillis
類型:  number
這是唯讀欄位。車輛位置過時的閾值。如果車輛最近一次更新的位置早於這個門檻,系統就不會顯示車輛。
taskFilterOptions
傳回擷取工作時要套用的篩選器選項。
沿用: isPollingpollingIntervalMillis
沿用: addListener
error
function(event)
引數: 
位置提供者發生錯誤時觸發的事件。
update
function(event)
完成 Fleet Engine 資料更新要求時觸發的事件。
沿用: ispollingchange

FleetEngineDeliveryVehicleLocationProviderOptions 介面

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderOptions 介面

運送車輛定位服務供應商的選項。

authTokenFetcher
類型:  AuthTokenFetcher
提供 JSON Web Token,向 Fleet Engine 驗證用戶端。
projectId
類型:  string
Google Cloud 控制台中的消費者專案 ID。
activePolylineCustomization optional
自訂套用至使用中的折線。有效的折線會對應車輛目前穿越的路線的一部分。

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

    如需提供的參數清單及其用途清單,請參閱 DeliveryVehiclePolylineCustomizationFunctionParams
deliveryVehicleId optional
類型:  string optional
位置供應商執行個體化後,要立即追蹤的配送車輛 ID。如未指定,位置供應商就不會開始追蹤任何車輛;請使用 FleetEngineDeliveryVehicleLocationProvider.deliveryVehicleId 設定 ID 並開始追蹤。
deliveryVehicleMarkerCustomization optional
自訂已套用至外送車輛標記。

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

    如需提供的參數清單及其用途,請參閱 DeliveryVehicleMarkerCustomizationFunctionParams
plannedStopMarkerCustomization optional
類型:  (function(PlannedStopMarkerCustomizationFunctionParams): void)|MarkerOptions optional
自訂套用至預定停靠站標記。

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

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

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

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

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

    如需提供的參數清單及其用途清單,請參閱 DeliveryVehiclePolylineCustomizationFunctionParams
shouldShowOutcomeLocations optional
類型:  boolean optional
此佈林值用於顯示或隱藏已擷取工作的結果位置。
shouldShowTasks optional
類型:  boolean optional
使用布林值顯示或隱藏工作。設為 false 可防止系統呼叫 ListTasks 端點以擷取工作。系統只會顯示即將到來的車輛停靠站。
staleLocationThresholdMillis optional
類型:  number optional
車輛位置過時的閾值。如果車輛最近一次更新的位置低於這個門檻,系統就不會顯示車輛。預設值為 24 小時 (毫秒)。如果門檻小於 0 或 Infinity,系統會忽略門檻,且車輛位置不會視為過時。
takenPolylineCustomization optional
自訂套用至繪製折線的折線。行星的折線對應於車輛已行駛的路線部分。

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

    如需提供的參數清單及其用途清單,請參閱 DeliveryVehiclePolylineCustomizationFunctionParams
taskFilterOptions optional
類型:  FleetEngineTaskFilterOptions optional
擷取工作時要套用的篩選器選項。選項可能包含特定的車輛、時間和工作狀態。
taskMarkerCustomization optional
類型:  (function(TaskMarkerCustomizationFunctionParams): void)|MarkerOptions optional
自訂工作已套用至工作標記。工作標記會在指派給貨運車輛的預定位置顯示。

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

    如需提供的參數清單及其用途,請參閱 TaskMarkerCustomizationFunctionParams
taskOutcomeMarkerCustomization optional
類型:  function(TaskMarkerCustomizationFunctionParams): void optional
自訂工作結果標記。工作結果標記會顯示在指派給外送車輛各項工作的實際結果位置。

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

    如需提供的參數清單及其用途,請參閱 TaskMarkerCustomizationFunctionParams

FleetEngineTaskFilterOptions 介面

google.maps.journeySharing.FleetEngineTaskFilterOptions 介面

配送車輛定位供應商工作的篩選選項。

completionTimeFrom optional
類型:  Date optional
作業完成時間的專屬下限。用來篩選在指定時間之後完成的工作。
completionTimeTo optional
類型:  Date optional
已完成的工作完成時間上限。用來篩選在指定時間之前完成的工作。
state optional
類型:  string optional
工作的狀態。有效值為「OPEN」或「已關閉」。

FleetEngineDeliveryVehicleLocationProviderUpdateEvent 介面

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent 介面

觸發 FleetEngineDeliveryVehicleLocationProvider.update 事件時,傳遞至事件處理常式的事件物件。

completedVehicleJourneySegments optional
類型:  Array<VehicleJourneySegment> optional
這輛車完成的旅程區隔。無法修改。
deliveryVehicle optional
類型:  DeliveryVehicle optional
更新傳回的運輸車輛資料結構。無法修改。
tasks optional
類型:  Array<Task> optional
這輛外送車輛提供服務的工作清單。無法修改。

FleetEngineDeliveryFleetLocationProvider 類別

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProvider 類別

運送機群位置提供者。

這個類別會擴充 PollingLocationProvider

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

FleetEngineDeliveryFleetLocationProvider
FleetEngineDeliveryFleetLocationProvider(options)
參數: 
為 Fleet Engine 追蹤的車輛建立新的位置提供者。
deliveryVehicleFilter
類型:  string optional
擷取外送車輛時套用的篩選器。
locationRestriction
類型:  LatLngBounds|LatLngBoundsLiteral optional
用於追蹤運輸車輛的邊界。如未設定上下限,系統就不會追蹤任何運輸車輛。如要追蹤所有運送車輛,無論地點為何,請將邊界設為與整個地球相等。
staleLocationThresholdMillis
類型:  number
這是唯讀欄位。車輛位置過時的閾值。如果車輛最近一次更新的位置早於這個門檻,系統就不會顯示車輛。
沿用: isPollingpollingIntervalMillis
沿用: addListener
update
function(event)
完成 Fleet Engine 資料更新要求時觸發的事件。
沿用: ispollingchange

FleetEngineDeliveryFleetLocationProviderOptions 介面

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderOptions 介面

運送機群位置供應商的選項。

authTokenFetcher
類型:  AuthTokenFetcher
提供 JSON Web Token,向 Fleet Engine 驗證用戶端。
projectId
類型:  string
Google Cloud 控制台中的消費者專案 ID。
deliveryVehicleFilter optional
類型:  string optional
擷取外送車輛時要套用的篩選器查詢。這個篩選器會直接傳送至 Fleet Engine。

如要瞭解支援的格式,請參閱 ListDeliveryVehiclesRequest.filter

請注意,有效的屬性篩選器必須包含「屬性」前置字元。例如 attributes.x = "y"attributes."x y" = "z"
deliveryVehicleMarkerCustomization optional
類型:  function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional
自訂套用至外送車輛標記。

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

    如需提供的參數清單及其用途,請參閱 DeliveryVehicleMarkerCustomizationFunctionParams
locationRestriction optional
類型:  LatLngBounds|LatLngBoundsLiteral optional
定位提供者執行個體化後,應用於追蹤車輛的經緯度邊界。如果未設定,位置提供者不會開始追蹤任何車輛;使用 FleetEngineDeliveryFleetLocationProvider.locationRestriction 即可設定邊界並開始追蹤。如要追蹤所有運送車輛,無論地點為何,請將邊界設為與整個地球相等。
staleLocationThresholdMillis optional
類型:  number optional
車輛位置過時的閾值。如果車輛最近一次更新的位置低於這個門檻,系統就不會顯示車輛。預設值為 24 小時 (毫秒)。如果門檻小於零或 Infinity,系統會忽略門檻,且車輛位置不會視為過時。

FleetEngineDeliveryFleetLocationProviderUpdateEvent 介面

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent 介面

觸發 FleetEngineDeliveryFleetLocationProvider.update 事件時,傳遞至事件處理常式的事件物件。

deliveryVehicles optional
類型:  Array<DeliveryVehicle> optional
查詢傳回的送貨車輛清單。無法修改。