SearchVehiclesResponse

vehicles.search 응답 메시지입니다.

JSON 표현 
{
  "matches": [
    {
      object (VehicleMatch)
    }
  ]
}
입력란
matches[]

object (VehicleMatch)

SearchVehiclesRequest 기준과 일치하는 차량 목록으로, SearchVehiclesRequest.order_by 필드에 따라 정렬됩니다.

VehicleMatch

차량 SearchVehiclesRequest의 활성 이동 지점과 일치하는 차량 및 관련 추정치가 포함됩니다.

JSON 표현 
{
  "vehicle": {
    object (Vehicle)
  },
  "vehiclePickupEta": string,
  "vehiclePickupDistanceMeters": integer,
  "vehiclePickupStraightLineDistanceMeters": integer,
  "vehicleDropoffEta": string,
  "vehiclePickupToDropoffDistanceMeters": integer,
  "tripType": enum (TripType),
  "vehicleTripsWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "vehicleMatchType": enum (VehicleMatchType),
  "requestedOrderedBy": enum (VehicleMatchOrder),
  "orderedBy": enum (VehicleMatchOrder)
}
입력란
vehicle

object (Vehicle)

필수 항목입니다. 요청과 일치하는 차량입니다.
vehiclePickupEta

string (Timestamp format)

요청에 지정된 승차 지점까지 차량의 운전 도착예정시간입니다. 값이 비어 있으면 차량의 ETA 계산에 실패했음을 나타냅니다. SearchVehiclesRequest.include_back_to_back이(가) true이고 이 차량에 진행 중인 이동이 있는 경우 vehiclePickupEta에는 현재 진행 중인 이동을 완료하는 데 필요한 시간이 포함됩니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
vehiclePickupDistanceMeters

integer

차량의 현재 위치에서 요청에 지정된 승차 지점까지의 거리입니다. 기존 이동의 중간 승차 또는 하차 지점도 포함됩니다. 이 거리는 계산된 운전 (경로) 거리, 내비게이션 종료 지점과 요청된 승차 지점 사이의 직선 거리로 구성됩니다. 내비게이션 종료 지점과 요청된 승차 지점 사이의 거리는 일반적으로 작습니다. 값이 비어 있으면 거리 계산 시 오류가 있음을 나타냅니다.
vehiclePickupStraightLineDistanceMeters

integer

필수 항목입니다. 요청에 지정된 차량과 승차 지점 사이의 직선 거리입니다.
vehicleDropoffEta

string (Timestamp format)

요청에 지정된 하차 지점까지 전체 차량의 운전 도착예정시간입니다. ETA에는 요청에 지정된 dropoffPoint 전에 경유지에 정차하는 시간이 포함됩니다. 요청에 하차 지점이 지정된 경우에만 값이 채워집니다. 빈 값은 ETA를 계산하는 오류를 나타냅니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
vehiclePickupToDropoffDistanceMeters

integer

승차 지점에서 요청에 지정된 하차 지점까지의 차량 운전 거리 (미터)입니다. 거리는 두 지점 사이의 유일한 값이며, 차량 위치 또는 차량이 승차 지점 또는 하차 지점을 방문하기 전에 방문해야 하는 다른 지점은 포함되지 않습니다. 이 값은 요청에 dropoffPoint가 지정된 경우에만 채워집니다. 값이 비어 있으면 요청에 지정된 승차 지점에서 하차 지점까지의 거리를 계산하지 못했음을 나타냅니다.
tripType

enum (TripType)

필수 항목입니다. 승차 지점까지의 도착예정시간을 계산하는 데 사용된 요청의 이동 유형입니다.
vehicleTripsWaypoints[]

object (Waypoint)

도착예정시간을 계산하는 데 사용되는 경유지의 순서가 지정된 목록입니다. 이 목록에는 차량 위치, 진행 중인 차량 픽업 지점, 요청에 제공된 승차 지점이 포함됩니다. 빈 목록은 차량의 ETA 계산에 실패했음을 나타냅니다.
vehicleMatchType

enum (VehicleMatchType)

일치하는 차량 유형입니다.
requestedOrderedBy

enum (VehicleMatchOrder)

차량 일치 항목 정렬에 요청된 주문입니다.
orderedBy

enum (VehicleMatchOrder)

이 차량에 사용된 실제 주문입니다. 일반적으로 요청의 'orderBy' 필드와 일치하지만 내부 서버 오류와 같은 특정 상황에서는 다른 메서드를 사용할 수 있습니다 (예: PICKUP_POINT_STRAIGHT_DISTANCE).

경유지

SearchVehiclesResponse의 VehicleMatch 경로에 있는 중간 지점을 설명합니다. 이 개념은 다른 모든 엔드포인트에서 TripWaypoint로 표현됩니다.

JSON 표현 
{
  "latLng": {
    object (LatLng)
  },
  "eta": string
}
입력란
latLng

object (LatLng)

이 경유지의 위치입니다.
eta

string (Timestamp format)

차량이 이 경유지에 도착하는 예상 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

VehicleMatchType

차량 일치 유형입니다.

열거형
UNKNOWN 알 수 없는 차량 검색 유형
EXCLUSIVE 차량에 현재 지정된 이동이 없으며 승차 지점으로 이동할 수 있습니다.
BACK_TO_BACK 차량이 현재 이동에 지정되어 있지만 진행 중인 이동을 완료한 후 승차 지점으로 이동할 수 있습니다. 도착예정시간과 거리 계산 시 기존 이동경로를 고려합니다.
CARPOOL 차량에 탑승하기에 충분한 승차임이 있습니다.
CARPOOL_BACK_TO_BACK 차량이 승차 지점으로 이동하기 전에 현재 진행 중인 이동을 완료합니다. 도착예정시간과 거리 계산 시 기존 이동경로를 고려합니다.