SearchVehiclesResponse

vehicles.search 응답 메시지

JSON 표현
{
  "matches": [
    {
      object (VehicleMatch)
    }
  ]
}
필드
matches[]

object (VehicleMatch)

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

차량 매치

차량의 이동 상황과 일치하는 차량의 이동 상황 및 관련 추정치(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_backtrue 상태이고 차량에 활성 이동이 있는 경우 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를 계산하는 데 사용되는 경유지의 순서가 지정된 목록입니다. 목록에는 차량 위치, 차량에 대한 활성 경로의 승차 지점, 요청에 제공된 승차 지점이 포함됩니다. 빈 목록은 차량의 ETA 계산 실패를 나타냅니다.

vehicleMatchType

enum (VehicleMatchType)

차량 일치 유형입니다.

requestedOrderedBy

enum (VehicleMatchOrder)

차량 일치를 정렬하는 데 필요한 주문입니다.

orderedBy

enum (VehicleMatchOrder)

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

경유지

노선을 따라 있는 중간 지점을 설명합니다.

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".

차량 검색 유형

차량 일치 유형입니다.

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