資源:Trip
行程中繼資料。
JSON 表示法 |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
欄位 | |
---|---|
name |
僅供輸出。格式為「providers/{provider}/trips/{trip}」 |
vehicle |
進行這趟行程的車輛 ID。 |
trip |
行程的目前狀態。 |
trip |
行程類型。 |
pickup |
消費者指定的取貨地點。 |
actual |
僅供輸入。客戶上車時的實際位置。這個欄位可讓供應商針對實際的接送資訊提供意見回饋。 |
actual |
僅限輸入。司機抵達上車地點的實際時間和地點。這個欄位可讓供應商提供實際抵達上車地點的資訊。 |
pickup |
僅供輸出。乘客預計上車的時間,或實際上車的時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 規格化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
intermediate |
行程要求的中途停靠站 (除了上車和下車地點)。這項功能一開始不會支援共乘行程。 |
intermediate |
表示上次修改 使用 RFC 3339,產生的輸出內容一律會經過 Z 規格化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
intermediate |
當 |
actual |
僅限輸入。司機抵達中途目的地的實際時間和地點。這個欄位可讓供應商針對中途目的地的實際到達資訊提供意見回饋。 |
actual |
僅限輸入。客戶從中途目的地搭車的實際時間和地點。這個欄位可讓供應商針對中途目的地的實際上車資訊提供意見回饋。 |
dropoff |
客戶表示要下車的地點。 |
actual |
僅限輸入。乘客下車的實際時間和地點。這個欄位可讓供應商提供實際下車資訊的意見回饋。 |
dropoff |
僅供輸出。乘客抵達最終目的地的預估時間,或實際下車時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 規格化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
remaining |
僅供輸出。從目前位置到下車點的完整路徑,包括兩者。這個路徑可能包含其他行程的路線控點。 |
vehicle |
這個欄位可讓你手動排序行程的路線控點。這項資訊包含指派車輛的所有剩餘路線點,以及這趟行程的上下車路線點。如果行程尚未指派給車輛,Fleet Engine 會忽略這個欄位。基於隱私權考量,只有在 |
route[] |
僅供輸出。這趟行程預期的路線,從起點到 remainingWaypoints 中的首個項目。請注意,第一個路線點可能屬於不同的行程。 |
current |
僅供輸出。下一個路標的經過編碼的路徑。 注意:這個欄位僅供 Driver SDK 和 Consumer SDK 使用。尚未支援解碼。 |
current |
僅供輸出。表示路線上次修改的時間。 注意:這個欄位僅供 Driver SDK 和 Consumer SDK 使用。 使用 RFC 3339,產生的輸出內容一律會經過 Z 規格化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
current |
僅供輸出。指出 注意:這個欄位僅供 Driver SDK 和 Consumer SDK 使用。 |
current |
僅供輸出。表示上次修改 注意:這個欄位僅供 Driver SDK 和 Consumer SDK 使用。 使用 RFC 3339,產生的輸出內容一律會經過 Z 規格化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
current |
僅供輸出。 |
remaining |
僅供輸出。 |
eta |
僅供輸出。到下一個路標的預估到達時間 ( 使用 RFC 3339,產生的輸出內容一律會經過 Z 規格化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
remaining |
僅供輸出。從傳回行程資料到 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
remaining |
僅供輸出。指出上次變更 使用 RFC 3339,產生的輸出內容一律會經過 Z 規格化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
remaining |
僅供輸出。表示上次修改 使用 RFC 3339,產生的輸出內容一律會經過 Z 規格化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
number |
不可變動。表示這趟行程的乘客人數,不含駕駛人。車輛必須有可用容量,才能在 |
last |
僅供輸出。指出車輛在路線上最後回報的位置。 |
last |
僅供輸出。指出車輛的 |
view |
要填入的 Trip 欄位子集,以及如何解讀這些欄位。 |
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 |
指出停止時間。 使用 RFC 3339,產生的輸出內容一律會經過 Z 規格化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
stopTime |
僅限輸入。已淘汰,使用時間戳記欄位。 使用 RFC 3339,產生的輸出內容一律會經過 Z 規格化,並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如: |
TripView
trips.get
回應中不同組別的 Trip 欄位選擇器。請參閱 AIP-157 瞭解相關背景資訊。可能會新增其他檢視畫面。
列舉 | |
---|---|
TRIP_VIEW_UNSPECIFIED |
預設值。為了兼顧回溯相容性,API 預設會顯示 SDK 檢視畫面。為確保穩定性和支援服務,建議客戶選取 SDK 以外的 TripView 。 |
SDK |
包括使用公開可用的程式庫時可能無法解讀或支援的欄位。 |
JOURNEY_SHARING_V1S |
行程欄位會根據旅程分享用途填入資料。這個檢視畫面適用於伺服器對伺服器通訊。 |
方法 |
|
---|---|
|
在車隊引擎中建立行程,並傳回新行程。 |
|
取得單趟行程的資訊。 |
|
取得特定車輛的所有行程。 |
|
更新行程資料。 |