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 Console 中的消費者專案 ID。
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。
shouldShowOutcomeLocations optional
類型:  boolean optional
用於顯示或隱藏已擷取工作的結果位置的布林值。
shouldShowTasks optional
類型:  boolean optional
可顯示或隱藏工作的布林值。如果將這個值設為 False,系統會禁止呼叫 ListTasks 端點以擷取工作。系統只會顯示即將到來的車輛停靠站。
staleLocationThresholdMillis optional
類型:  number optional
車輛過時位置的門檻。如果車輛上次更新的地點距離這個門檻過舊,系統就不會顯示車輛。預設值為 24 小時 (毫秒)。如果門檻低於 0 或 Infinity,系統會忽略該門檻,並將車輛位置視為過時。
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 類別

「貨物運送位置」提供者。

此類別會擴充 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 Console 中的消費者專案 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 小時 (毫秒)。如果門檻低於 0 或 Infinity,系統會忽略這個門檻,並將車輛位置視為過時。

FleetEngineDeliveryFleetLocationProviderUpdateEvent 介面

google.maps.journeySharing.FleetEngineDeliveryFleetLocationProviderUpdateEvent 介面

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

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