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
這項工作剩餘待完成的區隔相關資訊。
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
指派給這部送貨車輛的行程路段，從車輛最近回報的位置開始。只有透過 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
車輛目前的導航狀態。
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
路徑中間隔起點的索引，從零開始。