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 車輛建立新的位置提供者。
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 Console 取得的專案 ID。
destinationMarkerCustomization optional
已為車輛行程目的地標記自訂設定。

這個欄位用於指定自訂樣式 (例如標記圖示) 和互動元素 (例如點擊處理)。
  • 如果指定 MarkerOptions 物件，則在建立標記後，系統會將標記中指定的變更套用至標記，並覆寫預設選項 (如果有的話)。
  • 如果指定了函式，系統會在建立標記時叫用一次函式，然後再加入地圖檢視。(在此叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當位置提供者透過 Fleet Engine 接收資料時，系統會叫用此函式 (不論該標記對應的資料是否已變更)。

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

這個欄位用於指定自訂樣式 (例如標記圖示) 和互動元素 (例如點擊處理)。
  • 如果指定 MarkerOptions 物件，則在建立標記後，系統會將標記中指定的變更套用至標記，並覆寫預設選項 (如果有的話)。
  • 如果指定了函式，系統會在建立標記時叫用一次函式，然後再加入地圖檢視。(在此叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當位置提供者透過 Fleet Engine 接收資料時，系統會叫用此函式 (不論該標記對應的資料是否已變更)。

    如需所列參數及其用途清單，請參閱 VehicleWaypointMarkerCustomizationFunctionParams。
originMarkerCustomization optional
適用於車輛行程起點標記。

這個欄位用於指定自訂樣式 (例如標記圖示) 和互動元素 (例如點擊處理)。
  • 如果指定 MarkerOptions 物件，則在建立標記後，系統會將標記中指定的變更套用至標記，並覆寫預設選項 (如果有的話)。
  • 如果指定了函式，系統會在建立標記時叫用一次函式，然後再加入地圖檢視。(在此叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當位置提供者透過 Fleet Engine 接收資料時，系統會叫用此函式 (不論該標記對應的資料是否已變更)。

    如需所列參數及其用途清單，請參閱 VehicleWaypointMarkerCustomizationFunctionParams。
pollingIntervalMillis optional
類型：  number optional
擷取位置更新通知的最短時間，以毫秒為單位。如果擷取作業的所需時間超過 pollingIntervalMillis，要等到目前位置更新後，系統才會開始下次位置更新。

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

預設的輪詢間隔為 5000 毫秒，最短間隔。如果將輪詢間隔時間設為非零的值，則會使用 5000。
staleLocationThresholdMillis optional
類型：  number optional
過時車輛位置的門檻。如果這輛車的最後更新位置為這個門檻，車輛就不會顯示。預設值為 24 小時 (以毫秒為單位)。如果閾值小於 0，或是「Infinity」，則系統會忽略門檻，且不會將車輛位置視為過時。
vehicleId optional
類型：  string optional
定位器執行個體化後，立即追蹤的車輛 ID。如未指定，則定位服務供應商不會開始追蹤任何車輛；請使用 FleetEngineVehicleLocationProvider.vehicleId 設定 ID，並開始追蹤。
vehicleMarkerCustomization optional
類型：  (function(VehicleMarkerCustomizationFunctionParams): void)|MarkerOptions optional
適用於車輛標記的自訂設定。

這個欄位用於指定自訂樣式 (例如標記圖示) 和互動元素 (例如點擊處理)。
  • 如果指定 MarkerOptions 物件，則在建立標記後，系統會將標記中指定的變更套用至標記，並覆寫預設選項 (如果有的話)。
  • 如果指定了函式，系統會在建立標記時叫用一次函式，然後再加入地圖檢視。(在此叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當位置提供者透過 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 Console 取得的專案 ID。
locationRestriction optional
類型：  LatLngBounds|LatLngBoundsLiteral optional
位置化服務執行個體化後，用於追蹤車輛的經緯度邊界。如果未設定，位置提供者不會開始追蹤任何車輛；請使用 FleetEngineFleetLocationProvider.locationRestriction 設定邊界並開始追蹤。如要追蹤所有位置的車輛，請將邊界設為與整個地球相等。
staleLocationThresholdMillis optional
類型：  number optional
過時車輛位置的門檻。如果這輛車的最後更新位置超過這個門檻，系統就不會顯示該車輛。預設值為 24 小時 (以毫秒為單位)。如果門檻值小於或等於「Infinity」，系統會忽略門檻，且不會將車輛位置視為過時。
vehicleFilter optional
類型：  string optional
擷取車輛時所套用的篩選查詢。這個篩選器會直接傳送至 Fleet Engine。

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

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

這個欄位用於指定自訂樣式 (例如標記圖示) 和互動元素 (例如點擊處理)。
  • 如果指定 MarkerOptions 物件，則在建立標記後，系統會將標記中指定的變更套用至標記，並覆寫預設選項 (如果有的話)。
  • 如果指定了函式，系統會在建立標記時叫用一次函式，然後再加入地圖檢視。(在此叫用中，函式參數物件中的 isNew 參數會設為 true)。此外，當位置提供者透過 Fleet Engine 接收資料時，系統會叫用此函式 (不論該標記對應的資料是否已變更)。

    如需所列參數及其用途清單，請參閱 VehicleMarkerCustomizationFunctionParams。

FleetEngineFleetLocationProviderUpdateEvent 介面

google.maps.journeySharing.FleetEngineFleetLocationProviderUpdateEvent 介面

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