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 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (TerminalLocation)

根据行程请求的中间停靠站（除上车点和下车点之外）。最初，共享行程不支持此功能。

string (Timestamp format)

表示上次修改 intermediateDestinations 的时间。您的服务器应缓存此值，并在更新 intermediateDestinationIndex 时将其传入 UpdateTripRequest，以确保 intermediateDestinations 不会被更改。

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："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 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："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)

仅供输出。此行程到 remainingWaypoints 中的第一个条目的预期路线。请注意，第一个航点可能属于其他行程。

string

仅供输出。前往下一个航点的编码路径。

注意：此字段仅供驱动程序 SDK 和消费者 SDK 使用。尚不支持解码。

string (Timestamp format)

仅供输出。指示上次修改路线的时间。

注意：此字段仅供驱动程序 SDK 和消费者 SDK 使用。

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (ConsumableTrafficPolyline)

仅供输出。指示currentRouteSegment沿线的路况（如有）。

注意：此字段仅供驱动程序 SDK 和消费者 SDK 使用。

string (Timestamp format)

仅供输出。表示上次修改 currentRouteSegmentTraffic 的时间。

注意：此字段仅供驱动程序 SDK 和消费者 SDK 使用。

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

object (TripWaypoint)

仅供输出。currentRouteSegment 结束的航点。

integer

仅供输出。currentRouteSegment 字段中的剩余行车距离。如果行程未分配给车辆，或者行程已完成或取消，该值将未指定。

string (Timestamp format)

仅供输出。前往下一个航点（remainingWaypoints 字段中的第一个条目）的预计到达时间。如果行程未分配给车辆，或者行程处于非活动状态（已完成或取消），该值将未指定。

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Duration format)

仅供输出。从行程数据返回到 Trip.eta_to_first_waypoint 时间之间的时长。如果行程未分配给车辆，或者行程处于非活动状态（已完成或取消），该值将未指定。

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

string (Timestamp format)

仅供输出。表示上次更改 remainingWaypoints（添加、移除或更改航点）的时间。

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："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 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

integer

不可变。表示此次行程的乘客人数，不包括司机。要在 vehicles.search 响应中返回车辆，必须有可用的容量。

object (VehicleLocation)

仅供输出。指示车辆沿路线最后报告的位置。

boolean

仅供输出。指示车辆的 lastLocation 是否可贴靠到 currentRouteSegment。如果 lastLocation 或 currentRouteSegment 不存在，则为 false。它由 Fleet Engine 计算。来自客户端的任何更新都将被忽略。

enum (TripView)

填充的行程字段子集以及应如何解读这些字段。

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

object (LatLng)

必需。表示实际位置。

string (Timestamp format)

指示停止发生的时间。

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string (Timestamp format)

仅限输入。已弃用。使用时间戳字段。

时间戳，采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，具有纳秒级分辨率，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。