Fleet Tracking - Last Mile Fleet

FleetEngineDeliveryVehicleLocationProvider 類別

google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProvider class

送貨車輛位置提供者。

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

    如要查看提供的參數和用途清單，請參閱 DeliveryVehicleMarkerCustomizationFunctionParams。
plannedStopMarkerCustomization optional
類型：  (function(PlannedStopMarkerCustomizationFunctionParams): void)|MarkerOptions optional
已將自訂內容套用至預定停靠點標記。

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

    如要查看提供的參數和用途清單，請參閱 TaskMarkerCustomizationFunctionParams。
taskOutcomeMarkerCustomization optional
類型：  function(TaskMarkerCustomizationFunctionParams): void optional
套用至工作結果標記的自訂項目。系統會在指派給遞送車輛的每項工作實際結果位置，顯示工作結果標記。

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

    如要查看提供的參數和用途清單，請參閱 TaskMarkerCustomizationFunctionParams。

FleetEngineTaskFilterOptions 介面

google.maps.journeySharing.FleetEngineTaskFilterOptions 介面

在運送車輛位置供應器中，篩選工作任務的選項。
completionTimeFrom optional
類型：  Date optional
任務完成時間的下限。用於篩選在指定時間後完成的工作。
completionTimeTo optional
類型：  Date optional
排除工作完成時間的上限。用於篩選在指定時間之前完成的工作。
state optional
類型：  string optional
工作狀態。有效值為 OPEN 或 CLOSED。

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 class

運送車隊位置提供工具。

這個類別會擴充 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」前置字串。例如 attributes.x = "y" 或 attributes."x y" = "z"。
deliveryVehicleMarkerCustomization optional
類型：  function(DeliveryVehicleMarkerCustomizationFunctionParams): void optional
套用自訂項目的運送車輛標記。

您可以使用這個欄位指定自訂樣式 (例如標記圖示) 和互動功能 (例如點擊處理)。
  • 如果指定 MarkerOptions 物件，系統會在標記建立後套用其中指定的變更，並覆寫標記的預設選項 (如果有)。
  • 如果指定函式，系統會在建立標記時呼叫該函式一次，然後再將標記加入地圖檢視畫面。(在這個叫用作業中，函式參數物件中的 isNew 參數會設為 true)。此外，無論與此標記相對應的資料是否已變更，位置供應器接收 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
查詢傳回的遞送車輛清單。無法修改。