資源:行程
行程中繼資料。
JSON 表示法 |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
欄位 | |
---|---|
name |
僅供輸出。格式為「provider/{provider}/trips/{trip}」 |
vehicleId |
這趟行程的車輛 ID。 |
tripStatus |
行程目前的狀態。 |
tripType |
行程類型。 |
pickupPoint |
供客戶取貨的位置。 |
actualPickupPoint |
僅限輸入。實際取貨時間和地點。供應商可在這個欄位中提供有關實際取貨資訊的意見回饋。 |
actualPickupArrivalPoint |
僅限輸入。司機抵達上車地點的實際時間和地點。供應商可透過這個欄位,就抵達上車地點的實際抵達資訊提供意見回饋。 |
pickupTime |
僅供輸出。可能是預計乘客上車時間的未來時間,或是他們上車地點的實際時間。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
intermediateDestinations[] |
中途停靠站,以按照行程要求行程 (除了上車和下車)。目前這項功能不適用於已分享的行程。 |
intermediateDestinationsVersion |
表示上次修改 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
intermediateDestinationIndex |
當 |
actualIntermediateDestinationArrivalPoints[] |
僅限輸入。駕駛人抵達中繼目的地的實際時間和地點。供應商可透過這個欄位,針對中繼目的地的實際抵達資訊提供意見回饋。 |
actualIntermediateDestinations[] |
僅限輸入。從中繼目的地取貨客戶的實際時間和地點。供應商可透過這個欄位,針對中繼目的地的實際取貨資訊提供意見回饋。 |
dropoffPoint |
消費者表示受訓人員等待的地點。 |
actualDropoffPoint |
僅限輸入。客戶退出後的實際時間和地點。供應商可在這個欄位中提供有關實際下車資訊的意見回饋。 |
dropoffTime |
僅供輸出。可能是乘客在最終目的地下車的預計未來時間,或是乘客下車的實際時間。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
remainingWaypoints[] |
僅供輸出。從目前位置到下車地點的完整路徑 (含)。此路徑可能包含其他行程的路線控點。 |
vehicleWaypoints[] |
這個欄位支援手動排序行程的路線控點。內含指定車輛所有其他路線控點,以及這趟行程的上車和下車路線控點。如果行程尚未指派給車輛,Fleet Engine 會忽略這個欄位。基於隱私考量,只有透過 |
route[] |
僅供輸出。這趟行程前往剩餘 Waypoints 中第一個入口的路線。請注意,第一個路線控點可能屬於不同的行程。 |
currentRouteSegment |
僅供輸出。前往下一個路線控點的編碼路徑。 注意:這個欄位僅供驅動程式 SDK 和 Consumer SDK 使用。目前不支援解碼。 |
currentRouteSegmentVersion |
僅供輸出。指出上次修改路線的時間。 注意:這個欄位僅供驅動程式 SDK 和 Consumer SDK 使用。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
currentRouteSegmentTraffic |
僅供輸出。指出 注意:這個欄位僅供驅動程式 SDK 和 Consumer SDK 使用。 |
currentRouteSegmentTrafficVersion |
僅供輸出。表示上次修改 注意:這個欄位僅供驅動程式 SDK 和 Consumer SDK 使用。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
currentRouteSegmentEndPoint |
僅供輸出。 |
remainingDistanceMeters |
僅供輸出。 |
etaToFirstWaypoint |
僅供輸出。到下一個路線控點的預計到達時間 ( RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
remainingTimeToFirstWaypoint |
僅供輸出。從行程資料傳回 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
remainingWaypointsVersion |
僅供輸出。表示上次變更 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
remainingWaypointsRouteVersion |
僅供輸出。表示上次修改 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
numberOfPassengers |
不可變動。用於表示這趟行程的乘客人數,不包括司機。車輛必須有可用容量,才能在 |
lastLocation |
僅供輸出。用於指出沿途車輛上次回報的位置。 |
lastLocationSnappable |
僅供輸出。用於指出車輛的 |
view |
已填入的行程欄位子集及應如何解讀。 |
TripStatus
行程的狀態,表示其進度。
列舉 | |
---|---|
UNKNOWN_TRIP_STATUS |
預設值,用於未指定或無法辨識的行程狀態。 |
NEW |
新建立的行程。 |
ENROUTE_TO_PICKUP |
司機正在前往上車地點。 |
ARRIVED_AT_PICKUP |
司機已抵達上車地點。 |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
駕駛人已抵達中繼目的地,正在等候乘客。 |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
駕駛正在前往中繼目的地 (而非下車點)。 |
ENROUTE_TO_DROPOFF |
司機已上車,正在前往下一個目的地。 |
COMPLETE |
乘客已下車,行程也已完成。 |
CANCELED |
駕駛、乘客或共乘服務業者在上車前取消了行程。 |
StopLocation
發生停靠站 (上車/下車地點) 的實際位置。
JSON 表示法 |
---|
{
"point": {
object ( |
欄位 | |
---|---|
point |
必要欄位。表示實際位置。 |
timestamp |
表示停止發生的時間。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
stopTime |
僅限輸入。已淘汰,使用時間戳記欄位。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例: |
TripView
trips.get
回應中不同行程欄位組合的選取器。詳情請參閱 AIP-157。可能會增加額外的觀看次數。
列舉 | |
---|---|
TRIP_VIEW_UNSPECIFIED |
預設值。為了回溯相容,API 會預設為 SDK 檢視畫面。為確保穩定性和支援,建議客戶選擇 SDK 以外的 TripView 。 |
SDK |
包含可能無法透過公開可用的程式庫解釋或支援的欄位。 |
JOURNEY_SHARING_V1S |
系統會針對「旅程分享」用途填入行程欄位。這種檢視模式適用於伺服器對伺服器的通訊。 |
方法 |
|
---|---|
|
在 Fleet Engine 中建立行程並傳回新行程。 |
|
取得單一行程的相關資訊。 |
|
取得特定車輛的所有行程。 |
|
更新行程資料。 |