Method: providers.vehicles.search

{
  "header": {
    object (RequestHeader)
  },
  "pickupPoint": {
    object (TerminalLocation)
  },
  "dropoffPoint": {
    object (TerminalLocation)
  },
  "pickupRadiusMeters": integer,
  "count": integer,
  "minimumCapacity": integer,
  "tripTypes": [
    enum (TripType)
  ],
  "maximumStaleness": string,
  "vehicleTypes": [
    {
      object (VehicleType)
    }
  ],
  "requiredAttributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "requiredOneOfAttributes": [
    {
      object (VehicleAttributeList)
    }
  ],
  "requiredOneOfAttributeSets": [
    {
      object (VehicleAttributeList)
    }
  ],
  "orderBy": enum (VehicleMatchOrder),
  "includeBackToBack": boolean,
  "tripId": string,
  "currentTripsPresent": enum (CurrentTripsPresent)
}

object (RequestHeader)

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

object (TerminalLocation)

필수 항목입니다. 주변을 검색할 수령 지점입니다.

object (TerminalLocation)

고객이 의도한 하차 위치 tripTypes에 TripType.SHARED이 포함된 경우 이 필드는 필수입니다.

integer

필수 항목입니다. 수령 지점 주변의 차량 검색 반경을 정의합니다. 검색 반경 내의 차량만 반환됩니다. 값은 400~10,000미터 사이여야 합니다.

integer

필수 항목입니다. 반환할 최대 차량 수를 지정합니다. 값은 1 이상 50 이하여야 합니다.

integer

필수 항목입니다. 이동에 고려되는 승객 수를 지정합니다. 값은 1 이상이어야 합니다. 드라이버는 용량 값에 고려되지 않았습니다.

enum (TripType)

필수 항목입니다. 추천 이동 유형을 나타냅니다. 운영 가능한 차량은 지정된 이동 유형 중 하나 이상을 지원할 수 있는 차량입니다.

EXCLUSIVE 및 SHARED는 함께 포함할 수 없습니다. currentTripsPresent이 CURRENT_TRIPS_PRESENT_UNSPECIFIED이면 SHARED가 지원되지 않습니다.

string (Duration format)

지정된 기간 내에 위치를 업데이트한 차량으로 검색을 제한합니다. 이 필드를 설정하지 않으면 서버에서 5분을 기본값으로 사용합니다.

초 단위의 기간으로, 소수점 아래 9자리까지 지정되며 &s39;로 끝납니다. 예: "3.5s"

object (VehicleType)

필수 항목입니다. 지정된 유형 중 하나가 있는 차량으로 검색을 제한합니다. 차량 유형을 하나 이상 지정해야 합니다.

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

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

object (VehicleAttributeList)

각 VehicleAttributeList에 지정된 속성 중 하나 이상이 있는 차량으로 검색을 제한합니다. 각 목록 내에서 차량은 속성 중 하나 이상과 일치해야 합니다. 이 필드는 각 VehicleAttributeList의 포괄적 분리/OR 연산과 VehicleAttributeList 컬렉션의 combine/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 컬렉션 전반에 걸친 포함/분산 연산자입니다.

enum (VehicleMatchOrder)

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

boolean

활성 이동이 하나인 차량이 다른 일치에 적합한지 확인합니다. false인 경우 할당된 이동이 있는 차량이 검색결과에서 제외됩니다. true인 경우 검색결과에 TripStatus이 ENROUTE_TO_DROPOFF인 차량이 포함됩니다.

이 필드는 EXCLUSIVE의 단일 tripType가 지정된 경우에만 고려됩니다.

기본값은 false입니다.

string

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

enum (CurrentTripsPresent)

현재 이동 경로를 기준으로 검색결과에 차량이 표시되지 않도록 제한합니다.

currentTripsPresent가 NONE 또는 ANY인 경우 tripTypes는 EXCLUSIVE 또는 SHARED일 수 있지만 둘 다 될 수는 없습니다.