Fleet Engine Entities

Task 介面

google.maps.journeySharing.Task 介面

Fleet Engine 傳回的工作詳細資料。
attributes
類型：  Object<string, *>
指派給工作的屬性。
name
類型：  string
工作名稱，格式為「providers/{provider_id}/tasks/{task_id}」。task_id 必須是專屬 ID，而非追蹤 ID。如要儲存貨運的追蹤 ID，請使用「tracking_id」欄位。多項工作可共用同一個 track_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
工作結果位置的 setter (「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 正規化表單 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
Task 目前的執行狀態。
targetTimeWindow optional
類型：  TimeWindow optional
完成工作的時間範圍。
taskOutcome optional
類型：  string optional
嘗試執行 Task 的結果。
taskOutcomeTime optional
類型：  Date optional
供應器設定工作結果的時間。

Trip 介面

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 介面

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 介面

車輛歷程區隔類型
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 的定義。

Vehicle 介面

google.maps.journeySharing.Vehicle 介面

Fleet Engine 傳回的車輛詳細資料。
attributes
類型：  Object<string, *>
自訂車輛屬性。
name
類型：  string
格式為「providers/{provider_id}/vehicles/{vehicle_id}」。Car_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 可使用即時路線導航功能，駕駛應用程式導航功能已進入 GUIDED_NAV 模式。
NO_GUIDANCE 駕駛應用程式的導航模式為 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 介面

google.maps.journeySharing.SpeedReadingInterval 介面

連續路徑區隔上的流量密度指標。間隔會透過索引定義路段的起點和終點。
endPolylinePointIndex
類型：  number
路徑中間隔終點的從零開始索引。
speed
類型：  Speed
這個區間的流量速度。
startPolylinePointIndex
類型：  number
路徑中間隔起點的從零開始索引。