Method: providers.vehicles.search

object (RequestHeader)

표준 Fleet Engine 요청 헤더입니다.

object (TerminalLocation)

필수입니다. 근처에서 검색할 수령 지점입니다.

object (TerminalLocation)

고객이 원하는 반납 위치입니다. tripTypes에 TripType.SHARED가 포함된 경우 이 필드는 필수입니다.

integer

필수입니다. 픽업 지점 주변의 차량 검색 반경을 정의합니다. 검색 반경 내에 있는 차량만 반환됩니다. 값은 400~10,000미터 (양 끝값 포함)여야 합니다.

integer

필수입니다. 반환할 최대 차량 수를 지정합니다. 값은 1과 50 사이여야 합니다 (양 끝값 포함).

integer

필수입니다. 이동에 고려되는 승객 수를 지정합니다. 값은 1 이상이어야 합니다. 운전자는 용량 값에 포함되지 않습니다.

enum (TripType)

필수입니다. 제안된 이동의 유형을 나타냅니다. 정확히 하나의 유형을 포함해야 합니다. UNKNOWN_TRIP_TYPE은(는) 허용되지 않습니다. 해당 이동 유형을 지원할 수 있는 차량으로 검색을 제한합니다.

string (Duration format)

지정된 기간 내에 Fleet Engine에 위치 업데이트를 전송한 차량으로 검색을 제한합니다. 위치를 계속 전송하는 정지된 차량은 비활성 상태로 간주되지 않습니다. 이 필드를 설정하지 않으면 서버는 5분을 기본값으로 사용합니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

object (VehicleType)

필수입니다. 지정된 유형 중 하나가 있는 차량으로 검색을 제한합니다. 차량 유형을 하나 이상 지정해야 합니다. 카테고리가 UNKNOWN인 VehicleTypes는 허용되지 않습니다.

object (VehicleAttribute)

호출자는 requiredAttributes, requiredOneOfAttributes, requiredOneOfAttributeSets 필드의 조합을 사용하여 복잡한 논리 연산을 형성할 수 있습니다.

requiredAttributes는 목록입니다. requiredOneOfAttributes는 목록 목록을 허용하는 메시지를 사용합니다. 이 두 필드를 조합하면 다음 표현식을 구성할 수 있습니다.

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(requiredOneOfAttributes[0][0] OR requiredOneOfAttributes[0][1] OR
...)
AND
(requiredOneOfAttributes[1][0] OR requiredOneOfAttributes[1][1] OR
...)

지정된 속성이 있는 차량으로만 검색을 제한합니다. 이 필드는 연결/AND 연산입니다. requiredAttributes는 최대 50개까지 허용됩니다. 이는 차량에 허용되는 최대 속성 수와 일치합니다.

object (VehicleAttributeList)

각 VehicleAttributeList에 지정된 속성 중 하나 이상이 있는 차량으로 검색을 제한합니다. 각 목록 내에서 차량은 속성 중 하나 이상과 일치해야 합니다. 이 필드는 각 VehicleAttributeList의 양방향 선택/OR 연산이며 VehicleAttributeList 모음의 결합/AND 연산입니다.

object (VehicleAttributeList)

requiredOneOfAttributeSets는 추가 기능을 제공합니다.

requiredOneOfAttributes과 마찬가지로 requiredOneOfAttributeSets은 목록 목록을 허용하는 메시지를 사용하여 다음과 같은 표현식을 허용합니다.

(requiredAttributes[0] AND requiredAttributes[1] AND ...)
AND
(
  (requiredOneOfAttributeSets[0][0] AND
  requiredOneOfAttributeSets[0][1] AND
  ...)
  OR
  (requiredOneOfAttributeSets[1][0] AND
  requiredOneOfAttributeSets[1][1] AND
  ...)
)

VehicleAttributeList에 있는 모든 속성이 있는 차량으로 검색을 제한합니다. 각 목록 내에서 차량은 모든 속성과 일치해야 합니다. 이 필드는 각 VehicleAttributeList의 결합/AND 연산이며 VehicleAttributeList 모음 전체에 걸쳐 포용적 불리언/OR 연산입니다.

enum (VehicleMatchOrder)

필수입니다. 결과에 원하는 정렬 기준을 지정합니다.

boolean

활성 경로가 하나인 차량이 이 검색에 적합한지 여부를 나타냅니다. 이 필드는 currentTripsPresent가 지정되지 않은 경우에만 사용됩니다. currentTripsPresent가 지정되지 않고 이 필드가 false이면 할당된 이동이 있는 차량은 검색 결과에서 제외됩니다. currentTripsPresent가 지정되지 않고 이 필드가 true인 경우 검색 결과에 ENROUTE_TO_DROPOFF 상태의 활성 이동이 하나 있는 차량이 포함될 수 있습니다. currentTripsPresent가 지정된 경우 이 필드를 true로 설정할 수 없습니다.

기본값은 false입니다.

string

이 SearchVehicleRequest와 연결된 이동을 나타냅니다.

enum (CurrentTripsPresent)

활성 경로가 있는 차량이 이 검색에 적합한지 여부를 나타냅니다. tripType에 SHARED가 포함된 경우 CURRENT_TRIPS_PRESENT_UNSPECIFIED 이외의 값으로 설정해야 합니다.

string

선택사항입니다. 차량을 검색할 때 적용할 필터 쿼리입니다. 필터 문법의 예는 http://aip.dev/160을 참고하세요.

이 필드는 requiredAttributes, requiredOneOfAttributes, required_one_of_attributes_sets 필드를 대체하도록 설계되었습니다. 여기에 비어 있지 않은 값이 지정된 경우 requiredAttributes, requiredOneOfAttributes, required_one_of_attributes_sets 필드는 비어 있어야 합니다.

이 필터는 minimumCapacity 또는 vehicleTypes와 같은 다른 제약 조건과 함께 AND 절로 작동합니다.

차량 속성 (예: attributes.<key> = <value> 또는 attributes.<key1> = <value1> AND attributes.<key2> = <value2>)에 대한 쿼리만 지원됩니다. 필터 쿼리에 허용되는 최대 제한 수는 50개입니다.

또한 모든 속성은 문자열로 저장되므로 속성에 대해 지원되는 유일한 비교는 문자열 비교입니다. 숫자 또는 불리언 값과 비교하려면 값을 문자열로 처리되도록 명시적으로 따옴표로 묶어야 합니다 (예: attributes.<key> = "10" 또는 attributes.<key> = "true").