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

TripStatusENROUTE_TO_INTERMEDIATE_DESTINATION 时,表示车辆下一个要经过的中间目的地,介于 [0..N-1] 之间。当 TripStatusARRIVED_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 字段中的第一个条目)的剩余时间。

该时长以秒为单位,最多包含九个小数位,以“s”结尾。示例:"3.5s"

numberOfPassengers

integer

表示此行程的乘客人数(不包括司机)。车辆必须有空余载客量,才能在 SearchVehicles 中返回。

currentRouteSegmentTraffic

object (ConsumableTrafficPolylineLog)

当前路段的路况信息(如果有)。

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

双精度属性值。