Fleet Tracking - On Demand Rides & Delivery

FleetEngineVehicleLocationProvider class

google.maps.journeySharing.FleetEngineVehicleLocationProvider class

車輛位置供應商。

這個類別會擴充 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)。此外，無論對應這個標記的資料是否已變更，當位置資訊供應器從 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。
remainingPolylineCustomization optional
類型：  (function(VehiclePolylineCustomizationFunctionParams): void)|PolylineOptions optional
自訂設定會套用至其餘折線。剩餘折線對應車輛尚未開始行駛的路段。

使用這個欄位指定自訂樣式 (例如折線顏色) 和互動性 (例如點擊處理)。
  • 如果指定 PolylineOptions 物件，系統會在建立折線後，將其中指定的變更套用至折線，並覆寫預設選項 (如有)。
  • 如有指定函式，系統會在建立折線時呼叫該函式一次。(在此呼叫中，函式參數物件中的 isNew 參數會設為 true)。此外，無論對應這條折線的資料是否已變更，只要折線的座標變更，或位置資訊供應商從 Fleet Engine 接收資料，系統就會呼叫這個函式。

    如要查看提供的參數及其用途清單，請參閱 VehiclePolylineCustomizationFunctionParams。
staleLocationThresholdMillis optional
類型：  number optional
車輛位置資訊過時的門檻。如果車輛的最新位置資訊超過這個時間門檻，系統就不會顯示車輛。預設值為 24 小時 (以毫秒為單位)。如果門檻小於 0 或無限大，系統會忽略門檻，且不會將車輛位置視為過時。
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)。此外，無論對應這個標記的資料是否已變更，當位置資訊供應器從 Fleet Engine 接收資料時，系統都會呼叫這個函式。

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

FleetEngineVehicleLocationProviderUpdateEvent 介面

google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent 介面

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

FleetEngineFleetLocationProvider class

google.maps.journeySharing.FleetEngineFleetLocationProvider class

車隊位置資訊提供者。

這個類別會擴充 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 小時 (以毫秒為單位)。如果門檻小於零或為「無限大」，系統會忽略門檻，且不會將車輛位置視為過時。
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
查詢傳回的車輛清單。無法修改。