Fleet Tracking - On Demand Rides & Delivery (beta)

FleetEngineVehicleLocationProvider 類別

google.maps.journeySharing.FleetEngineVehicleLocationProvider 類別

車輛位置供應商。

這個類別會擴充 PollingLocationProvider。

呼叫 const {FleetEngineVehicleLocationProvider} = await google.maps.importLibrary("journeySharing") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
FleetEngineVehicleLocationProvider
FleetEngineVehicleLocationProvider(options)
參數： 
為 Fleet Engine 車輛建立新的定位服務供應商。
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params)
參數： 
傳回值：無
折線自訂函式會根據計算速度的讀數，在啟用中的折線上色。將這個函式指定為 FleetEngineVehicleLocationProviderOptions.activePolylineCustomization，即可為啟用中的折線算繪交通感知折線。
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION
TRAFFIC_AWARE_REMAINING_POLYLINE_CUSTOMIZATION_FUNCTION(params)
參數： 
傳回值：無
折線自訂功能，可根據讀數顯示其餘折線的顏色。將此函式指定為 FleetEngineVehicleLocationProviderOptions.remainingPolylineCustomization，為其餘折線算繪交通感知折線。
staleLocationThresholdMillis
類型：  number
這是唯讀欄位。車輛位置過時的閾值。如果車輛最近一次更新的位置早於這個門檻，系統就不會顯示車輛。
vehicleId
類型：  string
這個位置供應商觀察的車輛 ID。設定此欄位以追蹤車輛。
沿用： isPolling、pollingIntervalMillis
沿用： addListener
error
function(event)
引數： 
位置提供者發生錯誤時觸發的事件。
update
function(event)
引數： 
完成 Fleet Engine 資料更新要求時觸發的事件。
沿用： ispollingchange

FleetEngineVehicleLocationProviderOptions 介面

google.maps.journeySharing.FleetEngineVehicleLocationProviderOptions 介面

車輛定位服務供應商選項。
authTokenFetcher
類型：  AuthTokenFetcher
提供 JSON Web Token，向 Fleet Engine 驗證用戶端。
projectId
類型：  string
Google Cloud 控制台中的消費者專案 ID。
activePolylineCustomization optional
類型：  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional
自訂套用至使用中的折線。有效的折線會對應車輛目前穿越的路線的一部分。

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

    如需提供的參數清單及其用途清單，請參閱 VehiclePolylineCustomizationFunctionParams。
destinationMarkerCustomization optional
自訂設定已套用至車輛行程目的地標記。

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

    如需提供的參數清單及其用途，請參閱 VehicleWaypointMarkerCustomizationFunctionParams。
intermediateDestinationMarkerCustomization optional
自訂套用至車輛行程中繼目的地標記。

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

    如需提供的參數清單及其用途，請參閱 VehicleWaypointMarkerCustomizationFunctionParams。
originMarkerCustomization optional
自訂套用至車輛行程起點標記。

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

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

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

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

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

    如需提供的參數清單及其用途清單，請參閱 VehiclePolylineCustomizationFunctionParams。
staleLocationThresholdMillis optional
類型：  number optional
車輛位置過時的閾值。如果車輛最近一次更新的位置低於這個門檻，系統就不會顯示車輛。預設值為 24 小時 (毫秒)。如果門檻小於 0 或 Infinity，系統會忽略門檻，且車輛位置不會視為過時。
takenPolylineCustomization optional
類型：  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional
自訂套用至繪製折線的折線。行星的折線對應於車輛已行駛的路線部分。

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

    如需提供的參數清單及其用途清單，請參閱 VehiclePolylineCustomizationFunctionParams。
vehicleId optional
類型：  string optional
位置供應商執行個體化後，要立即追蹤的車輛 ID。如未指定，位置供應商就不會開始追蹤任何車輛；請使用 FleetEngineVehicleLocationProvider.vehicleId 設定 ID 並開始追蹤。
vehicleMarkerCustomization optional
類型：  (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional
自訂已套用至車輛標記。

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

    如需提供的參數清單及其用途，請參閱 VehicleMarkerCustomizationFunctionParams。

FleetEngineVehicleLocationProviderUpdateEvent 介面

google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent 介面

觸發 FleetEngineVehicleLocationProvider.update 事件時，傳遞至事件處理常式的事件物件。
trips optional
類型：  Array<Trip> optional
這輛車已完成的行程清單。無法修改。
vehicle optional
類型：  Vehicle optional
更新傳回的車輛資料結構。無法修改。

FleetEngineFleetLocationProvider 類別

google.maps.journeySharing.FleetEngineFleetLocationProvider 類別

機群位置提供者。

這個類別會擴充 PollingLocationProvider。

呼叫 const {FleetEngineFleetLocationProvider} = await google.maps.importLibrary("journeySharing") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
FleetEngineFleetLocationProvider
FleetEngineFleetLocationProvider(options)
參數： 
為 Fleet Engine 追蹤的車輛建立新的位置提供者。
locationRestriction
類型：  LatLngBounds|LatLngBoundsLiteral optional
用於追蹤車輛的界限。如果未設定邊界，系統就不會追蹤任何車輛。如要追蹤所有車輛位置，請將邊界設為與整個地球相等的邊界。
staleLocationThresholdMillis
類型：  number
這是唯讀欄位。車輛位置過時的閾值。如果車輛最近一次更新的位置早於這個門檻，系統就不會顯示車輛。
vehicleFilter
類型：  string optional
擷取車輛時套用的濾鏡。
沿用： isPolling、pollingIntervalMillis
沿用： addListener
update
function(event)
引數： 
完成 Fleet Engine 資料更新要求時觸發的事件。
沿用： ispollingchange

FleetEngineFleetLocationProviderOptions 介面

google.maps.journeySharing.FleetEngineFleetLocationProviderOptions 介面

機群位置供應商選項。
authTokenFetcher
類型：  AuthTokenFetcher
提供 JSON Web Token，向 Fleet Engine 驗證用戶端。
projectId
類型：  string
Google Cloud 控制台中的消費者專案 ID。
locationRestriction optional
類型：  LatLngBounds|LatLngBoundsLiteral optional
定位提供者執行個體化後，應用於追蹤車輛的經緯度邊界。如果未設定，位置提供者不會開始追蹤任何車輛；使用 FleetEngineFleetLocationProvider.locationRestriction 即可設定邊界並開始追蹤。如要追蹤所有車輛位置，請將邊界設為與整個地球相等的邊界。
staleLocationThresholdMillis optional
類型：  number optional
車輛位置過時的閾值。如果車輛最近一次更新的位置早於這個門檻，系統就不會顯示車輛。預設值為 24 小時 (毫秒)。如果門檻小於零或 Infinity，系統會忽略門檻，且車輛位置不會視為過時。
vehicleFilter optional
類型：  string optional
擷取車輛時要套用的篩選器查詢。這個篩選器會直接傳送至 Fleet Engine。

如要瞭解支援的格式，請參閱 ListVehiclesRequest.filter。

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

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

    如需提供的參數清單及其用途，請參閱 VehicleMarkerCustomizationFunctionParams。

FleetEngineFleetLocationProviderUpdateEvent 介面

google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent 介面

觸發 FleetEngineFleetLocationProvider.update 事件時，傳遞至事件處理常式的事件物件。
vehicles optional
類型：  Array<Vehicle> optional
查詢傳回的車輛清單。無法修改。