Fleet Tracking - On Demand Rides & Delivery

FleetEngineVehicleLocationProvider 類別

class google.maps.journeySharing.FleetEngineVehicleLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

車輛位置資訊提供者。

const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing");

建構函式
FleetEngineVehicleLocationProvider	FleetEngineVehicleLocationProvider(options) 參數： options: FleetEngineVehicleLocationProviderOptions 要傳遞給位置供應器的選項。 為 Fleet Engine 車輛建立新的位置資訊提供者。

靜態方法
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION	TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params) 參數： params: VehiclePolylineCustomizationFunctionParams：提供給折線自訂函式的參數。 傳回值：無 折線自訂函式，可根據速度讀數為使用中的折線著色。將這個函式指定為 FleetEngineVehicleLocationProviderOptions.activePolylineCustomization，為使用中的折線算繪車流感知折線。
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION	TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params) 參數： params: VehiclePolylineCustomizationFunctionParams：提供給折線自訂函式的參數。 傳回值：無 折線自訂函式，可根據速度讀數為剩餘折線上色。將這個函式指定為 FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization，為剩餘的折線算繪路況感知折線。

屬性
staleLocationThresholdMillis	類型： number 這個欄位為唯讀。車輛位置過時的門檻。如果車輛上次更新位置的時間早於這個門檻，系統就不會顯示該車輛。
vehicleId	類型： string 這個位置資訊提供者觀測的車輛 ID。設定這個欄位即可追蹤車輛。
繼承： isPolling、pollingIntervalMillis

方法
沿用： addListener

事件
error	function(event) 引數： event: ErrorEvent 位置供應器發生錯誤時觸發的事件。
update	function(event) 引數： event: FleetEngineVehicleLocationProviderUpdateEvent Fleet Engine 資料更新要求完成時觸發的事件。
沿用： ispollingchange

FleetEngineVehicleLocationProviderOptions 介面

介面 google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions

車輛位置資訊提供者的選項。

屬性
authTokenFetcher	類型： AuthTokenFetcher 提供 JSON Web Token，用於向 Fleet Engine 驗證用戶端。
projectId	類型： string Google Cloud 控制台中的消費者專案 ID。
activePolylineCustomization 選填	類型： (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional 自訂設定已套用至使用中的折線。有效折線對應車輛目前行經的部分路線。 使用這個欄位指定自訂樣式 (例如折線顏色) 和互動功能 (例如點擊處理)。 如果指定 PolylineOptions 物件，系統會在建立折線後，將物件中指定的變更套用至折線，並覆寫預設選項 (如有)。 如果指定函式，系統會在建立折線時叫用該函式一次。(在這次叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當折線座標變更，或位置供應器從 Fleet Engine 收到資料時，無論與這條折線對應的資料是否變更，都會叫用這個函式。 如需提供的參數清單和用途，請參閱 VehiclePolylineCustomizationFunctionParams。
destinationMarkerCustomization 選填	類型： (function(VehicleWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional 套用至車輛行程目的地標記的自訂設定。 使用這個欄位指定自訂樣式 (例如標記圖示) 和互動功能 (例如點擊處理)。 如果指定 MarkerOptions 物件，系統會在建立標記後，將其中指定的變更套用至標記，並覆寫預設選項 (如有)。 如果指定函式，系統會在建立標記時叫用一次，然後才將標記加入地圖檢視。(在這個叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當位置供應器從 Fleet Engine 接收資料時，無論與這個標記對應的資料是否已變更，都會叫用這個函式。 如需提供的參數清單和用途，請參閱 VehicleWaypointMarkerCustomizationFunctionParams。
intermediateDestinationMarkerCustomization 選填	類型： (function(VehicleWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional 套用至車輛行程中途目的地標記的自訂設定。 使用這個欄位指定自訂樣式 (例如標記圖示) 和互動功能 (例如點擊處理)。 如果指定 MarkerOptions 物件，系統會在建立標記後，將其中指定的變更套用至標記，並覆寫預設選項 (如有)。 如果指定函式，系統會在建立標記時叫用一次，然後才將標記加入地圖檢視。(在這個叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當位置供應器從 Fleet Engine 接收資料時，無論與這個標記對應的資料是否已變更，都會叫用這個函式。 如需提供的參數清單和用途，請參閱 VehicleWaypointMarkerCustomizationFunctionParams。
originMarkerCustomization 選填	類型： (function(VehicleWaypointMarkerCustomizationFunctionParams): void)|MarkerOptions optional 套用至車輛行程起點標記的自訂設定。 使用這個欄位指定自訂樣式 (例如標記圖示) 和互動功能 (例如點擊處理)。 如果指定 MarkerOptions 物件，系統會在建立標記後，將其中指定的變更套用至標記，並覆寫預設選項 (如有)。 如果指定函式，系統會在建立標記時叫用一次，然後才將標記加入地圖檢視。(在這個叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當位置供應器從 Fleet Engine 接收資料時，無論與這個標記對應的資料是否已變更，都會叫用這個函式。 如需提供的參數清單和用途，請參閱 VehicleWaypointMarkerCustomizationFunctionParams。
pollingIntervalMillis 選填	類型： number optional 擷取位置更新的最短時間間隔 (以毫秒為單位)。如果擷取位置更新的時間超過 pollingIntervalMillis，系統會等到目前的位置更新完成後，才會開始下一次位置更新。 如果將這個值設為 0，系統就會停用週期性位置更新。如果位置資訊供應商觀測的任何參數有所變更，系統就會擷取新的位置更新。 預設輪詢間隔為 5000 毫秒，這是最短間隔。如果將輪詢間隔設為較低的非零值，系統會使用 5000。
remainingPolylineCustomization 選填	類型： (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional 自訂設定已套用至其餘折線。剩餘折線對應車輛尚未開始行經的路線部分。 使用這個欄位指定自訂樣式 (例如折線顏色) 和互動功能 (例如點擊處理)。 如果指定 PolylineOptions 物件，系統會在建立折線後，將物件中指定的變更套用至折線，並覆寫預設選項 (如有)。 如果指定函式，系統會在建立折線時叫用該函式一次。(在這次叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當折線座標變更，或位置供應器從 Fleet Engine 收到資料時，無論與這條折線對應的資料是否變更，都會叫用這個函式。 如需提供的參數清單和用途，請參閱 VehiclePolylineCustomizationFunctionParams。
staleLocationThresholdMillis 選填	類型： number optional 車輛位置過時的門檻。如果車輛的上次更新位置早於這個門檻，系統就不會顯示該車輛。預設值為 24 小時 (以毫秒為單位)。如果門檻小於 0 或 Infinity，系統會忽略門檻，且不會將車輛位置視為過時。
takenPolylineCustomization 選填	類型： (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional 自訂設定已套用至所選折線。已行駛折線對應至車輛已行經的部分路線。 使用這個欄位指定自訂樣式 (例如折線顏色) 和互動功能 (例如點擊處理)。 如果指定 PolylineOptions 物件，系統會在建立折線後，將物件中指定的變更套用至折線，並覆寫預設選項 (如有)。 如果指定函式，系統會在建立折線時叫用該函式一次。(在這次叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當折線座標變更，或位置供應器從 Fleet Engine 收到資料時，無論與這條折線對應的資料是否變更，都會叫用這個函式。 如需提供的參數清單和用途，請參閱 VehiclePolylineCustomizationFunctionParams。
vehicleId 選填	類型： string optional 位置供應器例項化後，要立即追蹤的車輛 ID。如未指定，位置資訊提供者不會開始追蹤任何車輛；請使用 FleetEngineVehicleLocationProvider.vehicleId 設定 ID 並開始追蹤。
vehicleMarkerCustomization 選填	類型： (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional 套用至車輛標記的自訂設定。 使用這個欄位指定自訂樣式 (例如標記圖示) 和互動功能 (例如點擊處理)。 如果指定 MarkerOptions 物件，系統會在建立標記後，將其中指定的變更套用至標記，並覆寫預設選項 (如有)。 如果指定函式，系統會在建立標記時叫用一次，然後才將標記加入地圖檢視。(在這個叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當位置供應器從 Fleet Engine 接收資料時，無論與這個標記對應的資料是否已變更，都會叫用這個函式。 如需提供的參數清單和用途，請參閱 VehicleMarkerCustomizationFunctionParams。

FleetEngineVehicleLocationProviderUpdateEvent 介面

介面 google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent

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

屬性
trips 選填	類型： Array<Trip> optional 這輛車完成的行程清單。無法修改。
vehicle 選填	類型： Vehicle optional 更新傳回的車輛資料結構。無法修改。

FleetEngineFleetLocationProvider 類別

class google.maps.journeySharing.FleetEngineFleetLocationProvider extends PollingLocationProvider, LocationProvider
library "journeySharing"

Fleet Location Provider。

const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing");

建構函式
FleetEngineFleetLocationProvider	FleetEngineFleetLocationProvider(options) 參數： options: FleetEngineFleetLocationProviderOptions 要傳遞給位置供應器的選項。 為 Fleet Engine 追蹤的車輛建立新的位置資訊提供者。

屬性
locationRestriction	類型： LatLngBounds|LatLngBoundsLiteral optional 追蹤車輛的範圍。如未設定邊界，系統就不會追蹤任何車輛。如要追蹤所有車輛 (不限位置)，請將邊界設為整個地球。
staleLocationThresholdMillis	類型： number 這個欄位為唯讀。車輛位置過時的門檻。如果車輛上次更新位置的時間早於這個門檻，系統就不會顯示該車輛。
vehicleFilter	類型： string optional 擷取車輛時套用的篩選器。
繼承： isPolling、pollingIntervalMillis

方法
沿用： addListener

事件
update	function(event) 引數： event: FleetEngineFleetLocationProviderUpdateEvent Fleet Engine 資料更新要求完成時觸發的事件。
沿用： ispollingchange

FleetEngineFleetLocationProviderOptions 介面

介面 google.maps.journeySharing.FleetEngineFleetLocationProviderOptions

車隊位置供應商的選項。

屬性
authTokenFetcher	類型： AuthTokenFetcher 提供 JSON Web Token，用於向 Fleet Engine 驗證用戶端。
projectId	類型： string Google Cloud 控制台中的消費者專案 ID。
locationRestriction 選填	類型： LatLngBounds|LatLngBoundsLiteral optional 位置資訊供應器例項化後，立即追蹤車輛的經緯度範圍。如未設定，位置資訊提供者就不會開始追蹤任何車輛；請使用 FleetEngineFleetLocationProvider.locationRestriction 設定邊界並開始追蹤。如要追蹤所有車輛 (不限位置)，請將邊界設為整個地球。
staleLocationThresholdMillis 選填	類型： number optional 車輛位置過時的門檻。如果車輛的上次位置更新時間早於這個門檻，系統就不會顯示該車輛。預設值為 24 小時 (以毫秒為單位)。如果門檻小於零或 Infinity，系統會忽略門檻，且不會將車輛位置視為過時。
vehicleFilter 選填	類型： string optional 擷取車輛時要套用的篩選器查詢。這個篩選器會直接傳遞至 Fleet Engine。 如要瞭解支援的格式，請參閱 ListVehiclesRequest.filter。 請注意，有效的屬性篩選器必須加上「attributes」前置字串。例如 attributes.x = "y" 或 attributes."x y" = "z"。
vehicleMarkerCustomization 選填	類型： function(VehicleMarkerCustomizationFunctionParams): void optional 套用至車輛標記的自訂設定。 使用這個欄位指定自訂樣式 (例如標記圖示) 和互動功能 (例如點擊處理)。 如果指定 MarkerOptions 物件，系統會在建立標記後，將其中指定的變更套用至標記，並覆寫預設選項 (如有)。 如果指定函式，系統會在建立標記時叫用一次，然後才將標記加入地圖檢視。(在這個叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當位置供應器從 Fleet Engine 接收資料時，無論與這個標記對應的資料是否已變更，都會叫用這個函式。 如需提供的參數清單和用途，請參閱 VehicleMarkerCustomizationFunctionParams。

FleetEngineFleetLocationProviderUpdateEvent 介面

介面 google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent

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

屬性
vehicles 選填	類型： Array<Vehicle> optional 查詢傳回的車輛清單。無法修改。