- 资源:Trip
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TripStatus
- StopLocation
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- TripView
- 方法
资源:行程
行程元数据。
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 中创建行程并返回新行程。 |
|
获取单个行程的相关信息。 |
|
获取特定车辆的所有行程信息。 |
|
更新行程数据。 |