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
傳回擷取工作時要套用的篩選器選項。
沿用： isPolling、pollingIntervalMillis
沿用： 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
這是唯讀欄位。車輛位置過時的閾值。如果車輛最近一次更新的位置早於這個門檻，系統就不會顯示車輛。
沿用： isPolling、pollingIntervalMillis
沿用： 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
查詢傳回的送貨車輛清單。無法修改。