REST Resource: providers.trips

{
  "name": string,
  "vehicleId": string,
  "tripStatus": enum (TripStatus),
  "tripType": enum (TripType),
  "pickupPoint": {
    object (TerminalLocation)
  },
  "actualPickupPoint": {
    object (StopLocation)
  },
  "actualPickupArrivalPoint": {
    object (StopLocation)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocation)
    }
  ],
  "intermediateDestinationsVersion": string,
  "intermediateDestinationIndex": integer,
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocation)
    }
  ],
  "actualIntermediateDestinations": [
    {
      object (StopLocation)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "actualDropoffPoint": {
    object (StopLocation)
  },
  "dropoffTime": string,
  "remainingWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "vehicleWaypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "route": [
    {
      object (LatLng)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolyline)
  },
  "currentRouteSegmentTrafficVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "remainingWaypointsVersion": string,
  "remainingWaypointsRouteVersion": string,
  "numberOfPassengers": integer,
  "lastLocation": {
    object (VehicleLocation)
  },
  "lastLocationSnappable": boolean,
  "view": enum (TripView)
}

string

僅供輸出。格式為「providers/{provider}/trips/{trip}」

string

這趟行程的車輛 ID。

enum (TripStatus)

行程目前的狀態。

enum (TripType)

行程類型。

object (TerminalLocation)

供客戶取貨的位置。

object (StopLocation)

僅限輸入。實際取貨時間和地點。供應商可在這個欄位中提供有關實際取貨資訊的意見回饋。

object (StopLocation)

僅限輸入。司機抵達上車地點的實際時間和地點。這個欄位可讓供應商提供實際抵達上車地點的資訊。

string (Timestamp format)

僅供輸出。乘客預計上車的時間，或實際上車的時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (TerminalLocation)

中途停靠站，以按照行程要求行程 (除了上車和下車)。目前這項功能不適用於已分享的行程。

string (Timestamp format)

表示上次修改 intermediateDestinations 的時間。您的伺服器應在更新 intermediateDestinationIndex 時快取這個值，並在 UpdateTripRequest 中傳遞，以確保 intermediateDestinations 不會變更。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

integer

當 TripStatus 為 ENROUTE_TO_INTERMEDIATE_DESTINATION 時，[0..N-1] 之間的數字表示車輛下一個會經過哪個中途目的地。當 TripStatus 為 ARRIVED_AT_INTERMEDIATE_DESTINATION 時，介於 [0..N-1] 之間的數字，表示車輛目前位於哪個中繼目的地。這個值由提供者設定。如果沒有 intermediateDestinations，系統會忽略這個欄位。

object (StopLocation)

僅限輸入。司機抵達中途目的地的實際時間和地點。這個欄位可讓供應商針對中途目的地的實際到達資訊提供意見回饋。

object (StopLocation)

僅限輸入。從中繼目的地取貨客戶的實際時間和地點。供應商可透過這個欄位，針對中繼目的地的實際取貨資訊提供意見回饋。

object (TerminalLocation)

客戶表示要下車的地點。

object (StopLocation)

僅限輸入。乘客下車的實際時間和地點。這個欄位可讓供應商提供實際下車資訊的意見回饋。

string (Timestamp format)

僅供輸出。可能是乘客在最終目的地下車的預計未來時間，或是乘客下車的實際時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，解析度以奈秒為單位，小數點後最多 9 位。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (TripWaypoint)

僅供輸出。從目前位置到下車點的完整路徑，包括兩者。此路徑可能包含其他行程的路線控點。

object (TripWaypoint)

這個欄位支援手動排序行程的路線控點。內含指定車輛所有其他路線控點，以及這趟行程的上車和下車路線控點。如果行程尚未指派給車輛，Fleet Engine 會忽略這個欄位。基於隱私權考量，只有在 trips.update 和 trips.create 呼叫時，伺服器才會填入這個欄位，trips.get 呼叫則不會。

object (LatLng)

僅供輸出。這趟行程前往剩餘 Waypoints 中第一個入口的路線。請注意，第一個路線點可能屬於不同的行程。

string

僅供輸出。下一個路標的經過編碼的路徑。

注意：此欄位僅供 Driver SDK 和 Consumer SDK 使用。目前不支援解碼。

string (Timestamp format)

僅供輸出。表示路線上次修改的時間。

注意：此欄位僅供 Driver SDK 和 Consumer SDK 使用。

RFC3339 世界標準時間「Zulu」格式的時間戳記，解析度以奈秒為單位，小數點後最多 9 位。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (ConsumableTrafficPolyline)

僅供輸出。指出 currentRouteSegment 沿途的路況 (如有)。

注意：此欄位僅供 Driver SDK 和 Consumer SDK 使用。

string (Timestamp format)

僅供輸出。表示上次修改 currentRouteSegmentTraffic 的時間。

注意：這個欄位僅供驅動程式 SDK 和 Consumer SDK 使用。

RFC3339 世界標準時間「Zulu」格式的時間戳記，解析度以奈秒為單位，小數點後最多 9 位。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (TripWaypoint)

僅供輸出。currentRouteSegment 結束的路線點。

integer

僅供輸出。currentRouteSegment 欄位剩餘的行車距離。如果行程未指派給車輛，或是行程完成或取消，則未指定這個值。

string (Timestamp format)

僅供輸出。到下一個路線控點的預計到達時間 (remainingWaypoints 欄位中的第一個項目)。如果行程未指派給車輛，或是行程處於非活動狀態 (已完成或已取消)，則值未指定。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Duration format)

僅供輸出。從行程資料傳回 Trip.eta_to_first_waypoint 時間的期間。如果行程未指派給車輛，或是行程處於非活動狀態 (已完成或已取消)，則值未指定。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。

string (Timestamp format)

僅供輸出。指出上次變更 remainingWaypoints 的時間 (新增、移除或變更了路線點)。

RFC3339 世界標準時間「Zulu」格式的時間戳記，解析度以奈秒為單位，小數點後最多 9 位。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

僅供輸出。表示上次修改 remainingWaypoints.path_to_waypoint 和 remainingWaypoints.traffic_to_waypoint 的時間。您的用戶端應用程式應將這個值快取，並在 GetTripRequest 中傳遞，確保只有在更新時才會傳回 remainingWaypoints 的路徑和流量。

RFC3339 世界標準時間「Zulu」格式的時間戳記，解析度以奈秒為單位，小數點後最多 9 位。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

integer

不可變動。表示這趟行程的乘客人數，不含駕駛人。車輛必須有可用容量，才能在 vehicles.search 回應中傳回。

object (VehicleLocation)

僅供輸出。指出車輛在路線上最後回報的位置。

boolean

僅供輸出。用於指出車輛的 lastLocation 是否可媒合至目前 RouteSegment。如果 lastLocation 或 currentRouteSegment 不存在，則為 False。由車隊引擎計算。系統會忽略來自用戶端的任何更新。

enum (TripView)

要填入的 Trip 欄位子集，以及如何解讀這些欄位。

{
  "point": {
    object (LatLng)
  },
  "timestamp": string,
  "stopTime": string
}

object (LatLng)

必要欄位。表示實際位置。

string (Timestamp format)

表示停止發生的時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

僅限輸入。已淘汰，使用時間戳記欄位。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。