TripLog

Fleet Engine 中行程資源的記錄。

JSON 表示法 
{
  "name": string,
  "status": enum (TripStatusLog),
  "tripType": enum (TripTypeLog),
  "vehicleId": string,
  "lastLocation": {
    object (VehicleLocationLog)
  },
  "currentRouteSegmentEndPoint": {
    object (TripWaypointLog)
  },
  "pickupPoint": {
    object (TerminalLocationLog)
  },
  "actualPickupPoint": {
    object (StopLocationLog)
  },
  "actualPickupArrivalPoint": {
    object (StopLocationLog)
  },
  "pickupTime": string,
  "intermediateDestinations": [
    {
      object (TerminalLocationLog)
    }
  ],
  "intermediateDestinationIndex": integer,
  "intermediateDestinationsVersion": string,
  "actualIntermediateDestinations": [
    {
      object (StopLocationLog)
    }
  ],
  "actualIntermediateDestinationArrivalPoints": [
    {
      object (StopLocationLog)
    }
  ],
  "dropoffPoint": {
    object (TerminalLocationLog)
  },
  "actualDropoffPoint": {
    object (StopLocationLog)
  },
  "dropoffTime": string,
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeToFirstWaypoint": string,
  "numberOfPassengers": integer,
  "currentRouteSegmentTraffic": {
    object (ConsumableTrafficPolylineLog)
  },
  "attributes": [
    {
      object (TripAttributeLog)
    }
  ]
}
欄位
name

string

行程資源名稱，格式為 providers/{providerId}/trips/{tripId}。
status

enum (TripStatusLog)

行程狀態。
tripType

enum (TripTypeLog)

行程類型。
vehicleId

string

指派給行程的車輛 ID。
lastLocation

object (VehicleLocationLog)

車輛在路線上最後回報的位置。
currentRouteSegmentEndPoint

object (TripWaypointLog)

currentRouteSegment 結束的路線點。
pickupPoint

object (TerminalLocationLog)

消費者指定的取貨地點。
actualPickupPoint

object (StopLocationLog)

客戶實際上被載客的地點。
actualPickupArrivalPoint

object (StopLocationLog)

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

string (Timestamp format)

客戶的下車時間。可以是未來或過去的日期。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
intermediateDestinations[]

object (TerminalLocationLog)

在要求的順序中，除了上車和下車地點外，還包含中途停靠站。
intermediateDestinationIndex

integer

當 TripStatus 為 ENROUTE_TO_INTERMEDIATE_DESTINATION 時，[0..N-1] 之間的數字表示車輛下一個會經過哪個中途目的地。當 TripStatus 為 ARRIVED_AT_INTERMEDIATE_DESTINATION 時，[0..N-1] 之間的數字表示哪個中途目的地是車輛目前的位置。
intermediateDestinationsVersion

string (Timestamp format)

指定的中繼目的地版本

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
actualIntermediateDestinations[]

object (StopLocationLog)

從中途目的地接送乘客時的實際時間和地點。這個欄位可讓供應商針對中途目的地的實際接送資訊提供意見回饋。
actualIntermediateDestinationArrivalPoints[]

object (StopLocationLog)

駕駛人抵達中途目的地的實際時間和地點。這個欄位可讓供應商針對中途目的地的實際到達資訊提供意見回饋。
dropoffPoint

object (TerminalLocationLog)

客戶表示要下車的地點。
actualDropoffPoint

object (StopLocationLog)

乘客下車的實際位置。
dropoffTime

string (Timestamp format)

乘客下車或已下車的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
remainingDistanceMeters

integer

目前路線路段的剩餘行駛距離。
etaToFirstWaypoint

string (Timestamp format)

到下一個路標的預估到達時間 (Trip.remaining_waypoints 欄位中的第一個項目)。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
remainingTimeToFirstWaypoint

string (Duration format)

到下一個路標的剩餘時間 (Trip.remaining_waypoints 欄位中的第一個項目)。

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

integer

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

object (ConsumableTrafficPolylineLog)

如有提供，則為 currentRouteSegment 沿途的路況。
attributes[]

object (TripAttributeLog)

自訂行程屬性清單。

StopLocationLog

實際停靠 (上車/下車) 地點。

JSON 表示法 
{
  "timestamp": string,
  "point": {
    object (LatLng)
  }
}
欄位
timestamp

string (Timestamp format)

記錄位置的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 標準化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
point

object (LatLng)

表示停靠站的實際位置。

TripAttributeLog

以鍵/值組合表示的屬性，與行程相關。

JSON 表示法 
{
  "key": string,

  // Union field trip_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field trip_attribute_value.
}
欄位
key

string

屬性鍵。
聯集欄位 trip_attribute_value。屬性的值可以是字串、布林值或雙精度值。trip_attribute_value 只能是下列其中一項：
stringValue

string

字串型屬性值。
boolValue

boolean

布林型屬性值。
numberValue

number

雙精度浮點型屬性值。