Fleet Engine Entities

Task 介面

google.maps.journeySharing.Task 介面

注意：僅適用於 v=beta 版本。

Fleet Engine 傳回的工作詳細資料。

屬性
name	類型：string 工作名稱的格式為「providers/{provider_id}/task/{task_id}」。工作 ID 必須是專屬識別碼，不能是追蹤 ID。如要儲存運送追蹤 ID，請使用 tracking_id 欄位。可以同時將多項工作使用相同的 track_id。
remainingVehicleJourneySegments	類型：Array<VehicleJourneySegment> 這項工作所須完成的區隔相關資訊。
status	類型：string 工作目前的執行狀態。
type	類型：string 工作類型，例如休息或運送。
estimatedCompletionTime optional	類型：Date optional 工作預估完成時間的時間戳記。
latestVehicleLocationUpdate optional	類型：VehicleLocationUpdate optional 與上次位置更新相關的資訊。
outcome optional	類型：string optional 工作的結果。
outcomeLocation optional	類型：LatLngLiteral optional 工作完成的位置 (來自供應商)。
outcomeLocationSource optional	類型：string optional 工作結果位置的 setter (「PROVIDER」或「LAST_VEHICLE_LOCATION」)。
outcomeTime optional	類型：Date optional 工作結果的設定時間戳記 (來自供應商)。
plannedLocation optional	類型：LatLngLiteral optional 完成工作的位置。
trackingId optional	類型：string optional 貨品的追蹤 ID。
vehicleId optional	類型：string optional 執行這項工作的車輛 ID。

TaskTrackingInfo 介面

google.maps.journeySharing.TaskTrackingInfo 介面

注意：僅適用於 v=beta 版本。

Fleet Engine 傳回的工作追蹤資訊物件的詳細資料。

屬性
name	類型：string 格式為「providers/{provider_id}/taskTrackingInfo/{tracking_id}」，其中 tracking_id 代表追蹤 ID。
trackingId	類型：string 任務的追蹤 ID。 必須是有效的萬國碼 (Unicode) 字串。 長度上限為 64 個字元。 根據 Unicode 正規化表單 C 正規化。 不得包含下列任何 ASCII 字元：'/'、':'、'?'、',' 或 '#'。
estimatedArrivalTime optional	類型：Date optional 抵達停靠站的預估抵達時間。
estimatedTaskCompletionTime optional	類型：Date optional 工作的預估完成時間。
latestVehicleLocationUpdate optional	類型：VehicleLocationUpdate optional 與上次位置更新相關的資訊。
plannedLocation optional	類型：LatLng optional 完成工作的位置。
remainingDrivingDistanceMeters optional	類型：number optional 與感興趣的VehicleStop之間的總距離 (單位為公尺)。
remainingStopCount optional	類型：number optional 指出車輛到達停靠站前的停靠次數，包括停靠站。舉例來說，如果車輛的下一個停靠站是工作停靠站，這個值就會是 1。
routePolylinePoints optional	類型：Array<LatLng> optional 連接車輛預期路線的折線時，裝置的路徑清單。
state optional	類型：string optional 工作目前的執行狀態。
taskOutcome optional	類型：string optional 嘗試執行工作的工作結果。
taskOutcomeTime optional	類型：Date optional 供應程式設定工作的時間。

行程介面

google.maps.journeySharing.Trip 介面

注意：僅適用於 v=beta 版本。

Fleet Engine 傳回的行程詳細資料。

屬性
name	類型：string 格式為「providers/{provider_id}/trips/{trip_id}」。trip_id 必須是專屬識別碼。
passengerCount	類型：number 這趟行程的乘客人數，不含司機。
remainingWaypoints	類型：Array<VehicleWaypoint> 用來表示從目前位置到下車點的路徑的路徑點陣列。
status	類型：string 行程目前的狀態。可能的值包括 UNKNOWN_TRIP_STATUS、新的、ENROUTE_TO_PICKUP、ARRIVED_AT_PICKUP、ARRIVED_AT_INTERMEDIATE_DESTINATION、ENROUTE_TO_INTERMEDIATE_DESTINATION、ENROUTE_TO_DROPOFF、COMPLETE 或 CANCELED。
type	類型：string 行程的類型。可能的值包括 UNKNOWN_TRIP_TYPE、SHARED 或 EXCLUSIVE。
vehicleId	類型：string 這趟行程的車輛 ID。
actualDropOffLocation optional	類型：LatLngLiteral optional 客戶離開地點。
actualPickupLocation optional	類型：LatLngLiteral optional 客戶取貨的地點。
dropOffTime optional	類型：Date optional 預估乘客何時要下車，或他們離開後的實際時間。
latestVehicleLocationUpdate optional	類型：VehicleLocationUpdate optional 與上次位置更新相關的資訊。
pickupTime optional	類型：Date optional 預估乘客上車的時間，或實際抵達乘客的時間。
plannedDropOffLocation optional	類型：LatLngLiteral optional 客戶表示將離開的商家地點。
plannedPickupLocation optional	類型：LatLngLiteral optional 客戶表示他們會上車的地方。

DeliveryVehicle 介面

google.maps.journeySharing.DeliveryVehicle 介面

注意：僅適用於 v=beta 版本。

Fleet Engine 傳回的交貨車詳細資料。

屬性
attributes	類型：Object<string, string optional> 客製化交貨車屬性。
name	類型：string 格式為「providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}」。delivery_vehicle_id 必須是不重複的識別碼。
navigationStatus	類型：string 車輛目前的導航狀態。
remainingDistanceMeters	類型：number 目前航段的剩餘行駛距離，單位為公尺。
remainingVehicleJourneySegments	類型：Array<VehicleJourneySegment> 指派給這個運送車輛的旅程區隔 (以車輛最近回報的地點為起點)。
currentRouteSegmentEndPoint optional	類型：LatLngLiteral optional 目前路徑區隔的終點。
latestVehicleLocationUpdate optional	類型：VehicleLocationUpdate optional 上次回報車輛交付地點。
remainingDurationMillis optional	類型：number optional 目前路徑片段的剩餘行車時間 (以毫秒為單位)。

DeliveryVehicleStop 介面

google.maps.journeySharing.DeliveryVehicleStop 介面

注意：僅適用於 v=beta 版本。

交付車輛停靠站類型

屬性
tasks	類型：Array<{   id:string optional,   extraDurationMillis:number optional }> 這個停靠站要執行的工作清單。 id：工作 ID。 extraDurationMillis：執行工作所需的額外時間 (以毫秒為單位)。

DeliveryVehicleStopState 常數

google.maps.journeySharing.DeliveryVehicleStopState 常數

注意：僅適用於 v=beta 版本。

DeliveryVehicleStop 的目前狀態。

使用 &libraries=journeySharing 網址參數載入。請參閱 Maps JavaScript API 中的程式庫。

使用 v=beta 時，可透過呼叫 const {DeliveryVehicleStopState} = await google.map.importLibrary("journeySharing") 來存取請參閱 Maps JavaScript API 中的程式庫。

常數
ARRIVED	已抵達停靠站。假設車輛轉送到下一個停靠站時，所有先前的停靠站都已完成。
ENROUTE	已指派且主動轉送。
NEW	已建立，但目前並非主動轉送。
UNSPECIFIED	不明。

VehicleJourneySegment 介面

google.maps.journeySharing.VehicleJourneySegment 介面

注意：僅適用於 v=beta 版本。

交通工具旅程類型

屬性
drivingDistanceMeters optional	類型：number optional 從前一個停靠站到這個停靠站之間的移動距離，單位為公尺。
drivingDurationMillis optional	類型：number optional 從這個停靠站到這個停靠站的移動時間 (以毫秒為單位)。
path optional	類型：Array<LatLngLiteral> optional 從上一個路線控點 (或車輛目前位置，如果這個路徑點是路線控點清單中的第一個點) 至這個路線控點的路徑。
stop optional	類型：Array<DeliveryVehicleStop> optional 這輛車提供的停靠站。

VehicleLocationUpdate 介面

google.maps.journeySharing.VehicleLocationUpdate 介面

注意：僅適用於 v=beta 版本。

車輛位置更新類型

屬性
heading optional	類型：number optional 更新內容的標題。0 對應北方，180 對應南方。
location optional	類型：LatLngLiteral|LatLng optional 更新的位置。
speedKilometersPerHour optional	類型：number optional 時速 (公里)。
time optional	類型：Date optional 從車輛收到這項更新的時間。

VehicleWaypoint 介面

google.maps.journeySharing.VehicleWaypoint 介面

注意：僅適用於 v=beta 版本。

VehicleWaypoint 類型。

屬性
distanceMeters optional	類型：number optional 上一個路線控點 (或車輛目前位置，如果路線控點清單中是第一個點) 至這個路線控點之間的路徑距離，單位為公尺。
durationMillis optional	類型：number optional 從這個路線控點 (或路線控點清單中，第一個路線點) 至這個路線控點之間的行駛時間 (以毫秒為單位)。
location optional	類型：LatLngLiteral optional 路線控點的位置。
path optional	類型：Array<LatLngLiteral> optional 從上一個路線控點 (或車輛目前位置，如果這個路徑點是路線控點清單中的第一個點) 至這個路線控點的路徑。