本頁面由 Cloud Translation API 翻譯而成。

Fleet Engine Entities

工作介面

google.maps.journeySharing.Task 介面

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

屬性
`attributes`	類型： `Object<string, *>` 指派給工作的屬性。
`name`	類型： `string` 工作名稱的格式為「providers/{provider_id}/tasks/{task_id}」。task_id 必須是不重複的 ID，且不得為追蹤 ID。如要儲存貨件的追蹤 ID，請使用 tracking_id 欄位。多個工作可以有相同的 tracking_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` 工作結果位置的設定者 (「PROVIDER」或「LAST_VEHICLE_LOCATION」)。
`outcomeTime optional`	類型： `Date optional` 設定工作結果的時間戳記 (由供應商提供)。
`plannedLocation optional`	類型： `LatLngLiteral optional` 要完成工作的地點。
`targetTimeWindow optional`	類型： `TimeWindow optional` 應完成工作的時間範圍。
`trackingId optional`	類型： `string optional` 貨品的追蹤 ID。
`vehicleId optional`	類型： `string optional` 執行這項工作的車輛 ID。

TaskInfo 介面

google.maps.journeySharing.TaskInfo 介面

TaskInfo 型別，由 DeliveryVehicleStop 使用。

屬性
`extraDurationMillis optional`	類型： `number optional` 執行工作所需的額外時間 (以毫秒為單位)。
`id optional`	類型： `string optional` 工作 ID。
`targetTimeWindow optional`	類型： `TimeWindow optional` 應完成工作的時間範圍。

TaskTrackingInfo 介面

google.maps.journeySharing.TaskTrackingInfo 介面

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

屬性
`attributes`	類型： `Object<string, *>` 指派給工作的屬性。
`name`	類型： `string` 名稱格式為「providers/{provider_id}/taskTrackingInfo/{tracking_id}」，其中 `tracking_id` 代表追蹤 ID。
`trackingId`	類型： `string` 工作追蹤 ID。必須是有效的 Unicode 字串。長度上限為 64 個半形字元。根據 Unicode Normalization Form 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` 工作目前的執行狀態。
`targetTimeWindow optional`	類型： `TimeWindow optional` 應完成工作的時間範圍。
`taskOutcome optional`	類型： `string optional` 嘗試執行工作後的結果。
`taskOutcomeTime optional`	類型： `Date optional` 供應商設定工作結果的時間。

行程介面

google.maps.journeySharing.Trip 介面

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

屬性
`name`	類型： `string` 格式為「providers/{provider_id}/trips/{trip_id}」。trip_id 必須是不重複的 ID。
`passengerCount`	類型： `number` 這趟行程的乘客人數，不含司機。
`remainingWaypoints`	類型： `Array<VehicleWaypoint>` 路線控點陣列，指出從目前位置到下車地點的路徑。
`status`	類型： `string` 行程的目前狀態。可能的值包括 UNKNOWN_TRIP_STATUS、NEW、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 interface

google.maps.journeySharing.DeliveryVehicle 介面

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

屬性
`attributes`	類型： `Object<string, string optional>` 自訂送貨車輛屬性。
`name`	類型： `string` 格式為「providers/{provider_id}/deliveryVehicles/{delivery_vehicle_id}」。delivery_vehicle_id 必須是不重複的 ID。
`navigationStatus`	類型： `string` 車輛目前的導航狀態。
`remainingDistanceMeters`	類型： `number` 目前路段的剩餘行車距離 (以公尺為單位)。
`remainingVehicleJourneySegments`	類型： `Array<VehicleJourneySegment>` 指派給這部送貨車輛的行程路段，從車輛最近回報的位置開始。只有透過 `FleetEngineDeliveryVehicleLocationProvider` 提供 `DeliveryVehicle` 資料物件時，才會填入這個欄位。
`currentRouteSegmentEndPoint optional`	類型： `LatLngLiteral optional` 目前路段的終點。
`latestVehicleLocationUpdate optional`	類型： `VehicleLocationUpdate optional` 送貨車輛上次回報的位置。
`remainingDurationMillis optional`	類型： `number optional` 目前路段的剩餘駕駛時間 (以毫秒為單位)。

DeliveryVehicleStop 介面

google.maps.journeySharing.DeliveryVehicleStop 介面

DeliveryVehicleStop 類型

屬性
`tasks`	類型： `Array<TaskInfo>` 此停靠站要執行的工作清單。 `id`：工作 ID。 `extraDurationMillis`：執行工作所需額外時間，以毫秒為單位。
`plannedLocation optional`	類型： `LatLngLiteral optional` 停靠站的位置。
`state optional`	類型： `DeliveryVehicleStopState optional` 停靠站的狀態。

DeliveryVehicleStopState 常數

google.maps.journeySharing.DeliveryVehicleStopState 常數

DeliveryVehicleStop 的目前狀態。

撥打 const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

常數
`ARRIVED`	已抵達停靠站。假設車輛前往下一個停靠站時，已完成所有先前的停靠站。
`ENROUTE`	已指派並積極轉送。
`NEW`	已建立，但未主動轉送。
`UNSPECIFIED`	未知。

VehicleJourneySegment 介面

google.maps.journeySharing.VehicleJourneySegment 介面

VehicleJourneySegment 類型

屬性
`drivingDistanceMeters optional`	類型： `number optional` 從前一個停靠站到這個停靠站的行駛距離，以公尺為單位。
`drivingDurationMillis optional`	類型： `number optional` 從前一站到這一站的車程時間，以毫秒為單位。
`path optional`	類型： `Array<LatLngLiteral> optional` 從前一個停靠站 (或車輛目前位置，如果這個停靠站是停靠站清單中的第一個) 到這個停靠站的路徑。
`stop optional`	類型： `DeliveryVehicleStop optional` 停靠站的相關資訊。

VehicleLocationUpdate 介面

google.maps.journeySharing.VehicleLocationUpdate 介面

VehicleLocationUpdate 類型

屬性
`heading optional`	類型： `number optional` 更新的標題。0 代表北方，180 代表南方。
`location optional`	類型： `LatLngLiteral\|LatLng optional` 更新的位置。
`speedKilometersPerHour optional`	類型： `number optional` 速度 (以每小時公里數為單位)。
`time optional`	類型： `Date optional` 從車輛收到這項更新的時間。

VehicleWaypoint 介面

google.maps.journeySharing.VehicleWaypoint 介面

VehicleWaypoint 型別。

屬性
`distanceMeters optional`	類型： `number optional` 從前一個路線控點 (或車輛目前所在位置，如果這個路線控點是路線控點清單中的第一個) 到這個路線控點的路徑距離 (以公尺為單位)。
`durationMillis optional`	類型： `number optional` 從前一個路線控點 (或車輛目前所在位置，如果這個路線控點是路線控點清單中的第一個) 到這個路線控點的交通時間 (以毫秒為單位)。
`location optional`	類型： `LatLngLiteral optional` 航點位置。
`path optional`	類型： `Array<LatLngLiteral> optional` 從上一個路線控點 (或車輛目前位置，如果這個路線控點是路線控點清單中的第一個) 到這個路線控點的路徑。
`speedReadingIntervals optional`	類型： `Array<SpeedReadingInterval> optional` 從上一個途中的航點 (或車輛位置) 到目前航點的路徑，沿途的交通速度清單。清單中的每個間隔都說明路徑上連續路段的車流；間隔會透過索引定義路段的起點和終點。詳情請參閱`SpeedReadingInterval`的定義。

車輛介面

google.maps.journeySharing.Vehicle 介面

Fleet Engine 傳回的車輛詳細資料。

屬性
`attributes`	類型： `Object<string, *>` 自訂車輛屬性。
`name`	類型： `string` 格式為「providers/{provider_id}/vehicles/{vehicle_id}」。vehicle_id 必須是不重複的 ID。
`navigationStatus`	類型： `VehicleNavigationStatus` 車輛目前的導航狀態。
`remainingDistanceMeters`	類型： `number` 目前路段的剩餘行車距離 (以公尺為單位)。
`vehicleState`	類型： `VehicleState` 車輛狀態。
`vehicleType`	類型： `VehicleType` 這輛車的類型。
`currentRouteSegmentEndPoint optional`	類型： `TripWaypoint optional` 目前路段的終點航點。
`currentRouteSegmentVersion optional`	類型： `Date optional` 目前路徑區隔的設定時間。
`currentTrips optional`	類型： `Array<string> optional` 目前指派給這部車輛的行程 ID 清單。
`etaToFirstWaypoint optional`	類型： `Date optional` 抵達航點欄位中第一個項目的預計時間。
`latestLocation optional`	類型： `VehicleLocationUpdate optional` 車輛上次回報的位置。
`maximumCapacity optional`	類型： `number optional` 這輛車可搭載的乘客總數。這個值不包含司機。
`supportedTripTypes optional`	類型： `Array<TripType> optional` 這輛車支援的行程類型。
`waypoints optional`	類型： `Array<TripWaypoint> optional` 指派給這輛車的其餘航點。
`waypointsVersion optional`	類型： `Date optional` 上次更新航點欄位的時間。

VehicleNavigationStatus 常數

google.maps.journeySharing.VehicleNavigationStatus 常數

Vehicle 目前的導覽狀態。

撥打 const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

常數
`ARRIVED_AT_DESTINATION`	車輛距離目的地約 50 公尺。
`ENROUTE_TO_DESTINATION`	即時路線導航功能已啟用，且 Driver 應用程式導航功能已進入 GUIDED_NAV 模式。
`NO_GUIDANCE`	Driver 應用程式的導航功能處於 FREE_NAV 模式。
`OFF_ROUTE`	車輛已偏離建議路線。
`UNKNOWN_NAVIGATION_STATUS`	未指定導覽狀態。

VehicleState 常數

google.maps.journeySharing.VehicleState 常數

Vehicle 的目前狀態。

撥打 const {VehicleState} = await google.maps.importLibrary("journeySharing") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

常數
`OFFLINE`	車輛不接受新的行程。
`ONLINE`	車輛可接受新行程。
`UNKNOWN_VEHICLE_STATE`	車輛狀態不明。

VehicleType 常數

google.maps.journeySharing.VehicleType 常數

Vehicle 的類型。

撥打 const {VehicleType} = await google.maps.importLibrary("journeySharing") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

常數
`AUTO`	汽車。
`TAXI`	任何做為計程車的車輛 (通常須取得執照或受管制)。
`TRUCK`	儲存空間容量大的車輛。
`TWO_WHEELER`	機車、輕型機踏車或其他雙輪車輛。
`UNKNOWN`	車輛類型不明。

TripType 常數

google.maps.journeySharing.TripType 常數

Vehicle 支援的行程類型。

撥打 const {TripType} = await google.maps.importLibrary("journeySharing") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

常數
`EXCLUSIVE`	行程僅限車輛使用。
`SHARED`	行程可能會與其他行程共用車輛。
`UNKNOWN_TRIP_TYPE`	不明的行程類型。

TripWaypoint 介面

google.maps.journeySharing.TripWaypoint 介面

TripWaypoint 型別。

屬性
`distanceMeters optional`	類型： `number optional` 從前一個路線控點 (或車輛目前所在位置，如果這個路線控點是路線控點清單中的第一個) 到這個路線控點的路徑距離 (以公尺為單位)。
`durationMillis optional`	類型： `number optional` 從前一個路線控點 (或車輛目前所在位置，如果這個路線控點是路線控點清單中的第一個) 到這個路線控點的交通時間 (以毫秒為單位)。
`location optional`	類型： `LatLng optional` 航點位置。
`path optional`	類型： `Array<LatLng> optional` 從前一個停靠站 (或車輛目前位置，如果這個停靠站是停靠站清單中的第一個) 到這個停靠站的路徑。
`speedReadingIntervals optional`	類型： `Array<SpeedReadingInterval> optional` 從上一個途中的航點 (或車輛位置) 到目前航點的路徑，沿途的交通速度清單。清單中的每個間隔都說明路徑上連續路段的車流；間隔會透過索引定義路段的起點和終點。詳情請參閱`SpeedReadingInterval`的定義。
`tripId optional`	類型： `string optional` 與這個中途點相關聯的行程。
`waypointType optional`	類型： `WaypointType optional` 這個中途點在行程中扮演的角色，例如取貨或送達。

WaypointType 常數

google.maps.journeySharing.WaypointType 常數

Vehicle 支援的路線點類型。

撥打 const {WaypointType} = await google.maps.importLibrary("journeySharing") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

常數
`DROP_OFF_WAYPOINT_TYPE`	乘客下車的路線控點。
`INTERMEDIATE_DESTINATION_WAYPOINT_TYPE`	多目的地行程的中途目的地路線控點。
`PICKUP_WAYPOINT_TYPE`	乘客上車的路線控點。
`UNKNOWN_WAYPOINT_TYPE`	不明的航點類型。

TimeWindow 介面

google.maps.journeySharing.TimeWindow 介面

時間範圍。

屬性
`endTime`	類型： `Date` 時間範圍的結束時間 (含此時間)。
`startTime`	類型： `Date` 時間範圍的開始時間 (含)。

速度常數

google.maps.journeySharing.Speed 常數

根據交通流量資料分類折線速度。

撥打 const {Speed} = await google.maps.importLibrary("journeySharing") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

常數
`NORMAL`	速度正常，未偵測到變慢。
`SLOW`	偵測到車速減緩，但未形成交通壅塞。
`TRAFFIC_JAM`	系統偵測到交通壅塞。

SpeedReadingInterval interface

google.maps.journeySharing.SpeedReadingInterval 介面

連續路徑區段的交通密度指標。間隔會透過索引定義區段的起點和終點。

屬性
`endPolylinePointIndex`	類型： `number` 路徑中間隔的終點索引，從零開始。
`speed`	類型： `Speed` 這個時間間隔內的車速。
`startPolylinePointIndex`	類型： `number` 路徑中間隔起點的索引，從零開始。

Fleet Engine Entities 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

工作 介面

屬性