TripLog

Fleet Engine 中的 Trip 資源記錄檔。

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

用於表示這趟行程的乘客人數,不包括司機。車輛必須具備可用容量,才能在搜尋車輛中退回。

currentRouteSegmentTraffic

object (ConsumableTrafficPolylineLog)

如有提供,則會沿著目前 RouteSegment 沿途的路況顯示資料。

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)

表示停靠站的實際位置。