资源:行程
行程元数据。
JSON 表示法 |
---|
{ "name": string, "vehicleId": string, "tripStatus": enum ( |
字段 | |
---|---|
name |
仅供输出。格式为“providers/{provider}/trips/{trip}” |
vehicleId |
进行此次行程的车辆的 ID。 |
tripStatus |
行程的当前状态。 |
tripType |
行程的类型。 |
pickupPoint |
客户指明其上车地点。 |
actualPickupPoint |
仅限输入。上车客户的实际地点。此字段供提供商就实际自提信息提供反馈。 |
actualPickupArrivalPoint |
仅限输入。司机到达上车点的实际时间和位置。此字段供提供商针对上车点的实际到达信息提供反馈。 |
pickupTime |
仅供输出。乘客未来的预计上车时间,或乘客的实际上车时间。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
intermediateDestinations[] |
根据行程请求的中间停靠站(除上车点和下车点之外)。最初,共享行程不支持此功能。 |
intermediateDestinationsVersion |
表示上次修改 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
intermediateDestinationIndex |
当 |
actualIntermediateDestinationArrivalPoints[] |
仅限输入。司机到达中间目的地的实际时间和位置。此字段供提供商就中间目的地的实际到达信息提供反馈。 |
actualIntermediateDestinations[] |
仅限输入。从中间目的地接客客户的实际时间和地点。此字段供提供商针对中转目的地的实际上车信息提供反馈。 |
dropoffPoint |
客户表示将下车的地点。 |
actualDropoffPoint |
仅限输入。客户下车的实际时间和地点。此字段供提供商就实际下车信息提供反馈。 |
dropoffTime |
仅供输出。乘客未来预计会在最终目的地下车的时间,或他们实际下车的时间。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
remainingWaypoints[] |
仅供输出。从当前位置到下车点的完整路径(含边界值)。此路径可能包含来自其他行程的航点。 |
vehicleWaypoints[] |
此字段支持手动对行程的航点进行排序。它包含已分配车辆的所有剩余航点,以及此行程的上车点和下车点。如果未将行程分配给车辆,Fleet Engine 会忽略此字段。出于隐私原因,此字段仅在调用 |
route[] |
仅供输出。此行程到 remainingWaypoints 中的第一个条目的预期路线。请注意,第一个航点可能属于其他行程。 |
currentRouteSegment |
仅供输出。前往下一个航点的编码路径。 注意:此字段仅供驱动程序 SDK 和消费者 SDK 使用。尚不支持解码。 |
currentRouteSegmentVersion |
仅供输出。指示上次修改路线的时间。 注意:此字段仅供驱动程序 SDK 和消费者 SDK 使用。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
currentRouteSegmentTraffic |
仅供输出。指示 注意:此字段仅供驱动程序 SDK 和消费者 SDK 使用。 |
currentRouteSegmentTrafficVersion |
仅供输出。表示上次修改 注意:此字段仅供驱动程序 SDK 和消费者 SDK 使用。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
currentRouteSegmentEndPoint |
仅供输出。 |
remainingDistanceMeters |
仅供输出。 |
etaToFirstWaypoint |
仅供输出。前往下一个航点( 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
remainingTimeToFirstWaypoint |
仅供输出。从行程数据返回到 时长以秒为单位,最多包含九个小数位,以“ |
remainingWaypointsVersion |
仅供输出。表示上次更改 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
remainingWaypointsRouteVersion |
仅供输出。表示上次修改 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
numberOfPassengers |
不可变。表示此次行程的乘客人数,不包括司机。要在 |
lastLocation |
仅供输出。指示车辆沿路线最后报告的位置。 |
lastLocationSnappable |
仅供输出。指示车辆的 |
view |
填充的行程字段子集以及应如何解读这些字段。 |
TripStatus
表示行程进度的行程状态。
枚举 | |
---|---|
UNKNOWN_TRIP_STATUS |
默认,用于未指定或无法识别的行程状态。 |
NEW |
新建行程。 |
ENROUTE_TO_PICKUP |
司机正在前往上车点。 |
ARRIVED_AT_PICKUP |
司机已到达上车点。 |
ARRIVED_AT_INTERMEDIATE_DESTINATION |
司机已到达中转目的地,正在等待乘客。 |
ENROUTE_TO_INTERMEDIATE_DESTINATION |
司机正在前往中间目的地(而非下车点)。 |
ENROUTE_TO_DROPOFF |
司机已接起乘客,正在前往下一个目的地。 |
COMPLETE |
乘客已下车,行程已完成。 |
CANCELED |
在司机、乘客或拼车服务提供商取车之前,行程被取消。 |
StopLocation
发生经停点(上车/下车)的实际位置。
JSON 表示法 |
---|
{
"point": {
object ( |
字段 | |
---|---|
point |
必需。表示实际位置。 |
timestamp |
指示停止发生的时间。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
stopTime |
仅限输入。已弃用。使用时间戳字段。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
TripView
trips.get
响应中不同“行程”字段集的选择器。如需了解上下文,请参阅 AIP-157。可能会添加其他数据视图。
枚举 | |
---|---|
TRIP_VIEW_UNSPECIFIED |
默认值。为实现向后兼容性,该 API 将默认为 SDK 视图。为确保稳定性和支持服务,建议客户选择除 SDK 以外的 TripView 。 |
SDK |
包含使用公开库可能无法解释或支持的字段。 |
JOURNEY_SHARING_V1S |
系统会针对“行程分享”用例填充行程字段。此视图适用于服务器到服务器的通信。 |
方法 |
|
---|---|
|
在 Fleet Engine 中创建行程并返回新行程。 |
|
获取单个行程的相关信息。 |
|
获取特定车辆的所有行程。 |
|
更新行程数据。 |