vehicles.search
响应消息。
JSON 表示法 |
---|
{
"matches": [
{
object ( |
字段 | |
---|---|
matches[] |
符合 |
VehicleMatch
包含与车辆 SearchVehiclesRequest
的有效行程点匹配的车辆以及相关估算值。
JSON 表示法 |
---|
{ "vehicle": { object ( |
字段 | |
---|---|
vehicle |
必需。与请求匹配的车辆。 |
vehiclePickupEta |
车辆预计到达请求中指定的上车点的预计到达时间。空值表示计算车辆预计到达时间失败。如果 采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式的时间戳,采用纳秒级精度,最多包含九个小数位。示例: |
vehiclePickupDistanceMeters |
从车辆当前位置到请求中指定的上车点的距离,包括现有行程的任何中间上车点或下车点。此距离包括计算出的驾车(路线)距离,以及导航终点和请求的上车点之间的直线距离。(导航端点和请求的上车点之间的距离通常很小。)空值表示计算距离时出错。 |
vehiclePickupStraightLineDistanceMeters |
必需。车辆与请求中指定的上车点之间的直线距离。 |
vehicleDropoffEta |
整辆车的预计到达时间到达请求中指定的下车点。预计到达时间包括在请求中指定的 采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式的时间戳,采用纳秒级精度,最多包含九个小数位。示例: |
vehiclePickupToDropoffDistanceMeters |
车辆从上车点到请求中指定的下车点的行驶距离(以米为单位)。该距离仅在两点之间计算,不包括车辆位置或车辆到达上车点或下车点之前必须到达的任何其他点。仅当在请求中指定 |
tripType |
必需。用于计算上车点预计到达时间的请求的行程类型。 |
vehicleTripsWaypoints[] |
用于计算预计到达时间的有序航点列表。该列表包括车辆位置、车辆的有效行程的上车点,以及请求中提供的取车点。空列表表示计算车辆预计到达时间失败。 |
vehicleMatchType |
车辆匹配的类型。 |
requestedOrderedBy |
为车辆匹配项排序时请求的顺序。 |
orderedBy |
此车辆的实际订单。通常,这将匹配请求中的“orderBy”字段;但在某些情况下(例如发生内部服务器错误),也可以使用其他方法(例如 |
关键点
描述 SearchVehiclesResponse
中 VehicleMatch
的路线沿途的中间点。此概念在所有其他端点中表示为 TripWaypoint
。
JSON 表示法 |
---|
{
"latLng": {
object ( |
字段 | |
---|---|
latLng |
此航点的位置。 |
eta |
车辆到达此航点的预计时间。 采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式的时间戳,采用纳秒级精度,最多包含九个小数位。示例: |
VehicleMatchType
车辆匹配项的类型。
枚举 | |
---|---|
UNKNOWN |
未知的车辆匹配类型 |
EXCLUSIVE |
这辆车目前未分配任何行程,可以前往上车点。 |
BACK_TO_BACK |
车辆目前已分配给行程,但在完成进行中的行程后可以前往上车点。预计到达时间和距离计算会将现有行程考虑在内。 |
CARPOOL |
车辆的载客量足以容纳共享行程。 |
CARPOOL_BACK_TO_BACK |
车辆将结束当前正在进行的行程,然后再前往上车点。预计到达时间和距离计算会将现有行程考虑在内。 |