資源:行程
行程中繼資料。
JSON 表示法 |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
欄位 | |
---|---|
name |
僅供輸出。格式:「providers/{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 |
僅供輸出。下一個路線控點的編碼路徑。 注意:這個欄位僅供 Driver SDK 和 Consumer SDK 使用。目前不支援解碼。 |
currentRouteSegmentVersion |
僅供輸出。表示路線上次修改的時間。 注意:這個欄位僅供 Driver SDK 和 Consumer SDK 使用。 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例: |
currentRouteSegmentTraffic |
僅供輸出。表示 注意:這個欄位僅供 Driver SDK 和 Consumer SDK 使用。 |
currentRouteSegmentTrafficVersion |
僅供輸出。表示 注意:這個欄位僅供 Driver 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 中建立行程,並傳回新行程。 |
|
取得單趟行程的相關資訊。 |
|
取得特定車輛的所有行程。 |
|
更新行程資料。 |