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)
  }
}
欄位
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)

客戶的離開時間。可能是未來的或過去的時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

intermediateDestinations[]

object (TerminalLocationLog)

中期停靠站依要求的順序停靠 (除了上車和下車服務)。

intermediateDestinationIndex

integer

TripStatusENROUTE_TO_INTERMEDIATE_DESTINATION 時,介於 [0..N-1] 之間的數字,表示車輛接下來的交叉目的地。當 TripStatusARRIVED_AT_INTERMEDIATE_DESTINATION 時,介於 [0..N-1] 之間的數字,指出車輛目前的位置是哪個中繼目的地。

intermediateDestinationsVersion

string (Timestamp format)

指定的中繼目的地版本

RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

actualIntermediateDestinations[]

object (StopLocationLog)

消費者從中繼目的地取貨的實際時間和地點。供應商可運用這個欄位,針對中繼目的地的實際取貨資訊提供意見回饋。

actualIntermediateDestinationArrivalPoints[]

object (StopLocationLog)

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

dropoffPoint

object (TerminalLocationLog)

消費者表示即將下車的地點。

actualDropoffPoint

object (StopLocationLog)

顧客下車的實際地點。

dropoffTime

string (Timestamp format)

消費者預計或接送客戶的時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

remainingDistanceMeters

integer

目前路線路段中的剩餘行車距離。

etaToFirstWaypoint

string (Timestamp format)

預計到達下一個路線控點 (Trip.remaining_waypoints 欄位中的第一個項目)。

RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

remainingTimeToFirstWaypoint

string (Duration format)

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

持續時間以秒為單位,最多 9 個小數位數,結尾為「s」,例如:"3.5s"

numberOfPassengers

integer

指出這趟行程的乘客人數 (不含司機)。車輛必須有可用容量,才能在 SearchVehicles 中退還。

currentRouteSegmentTraffic

object (ConsumableTrafficPolylineLog)

可提供目前路線路段的路況 (如果有的話)。

StopLocationLog

發生停靠站 (上車/下車) 的實際地點。

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

string (Timestamp format)

記錄位置的時間戳記。

RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

point

object (LatLng)

表示停靠站的實際位置。