Method: providers.vehicles.searchFuzzed

HTTP 요청
경로 매개변수
요청 본문
- JSON 표현
응답 본문

지원 중단됨: 대신 vehicles.search를 사용하세요.

HTTP 요청

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles:searchFuzzed

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수

매개변수
`parent`	`string` 필수 항목입니다. `providers/{provider}` 형식이어야 합니다. 제공업체는 이 호출을 실행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID (예: `sample-cloud-project`)여야 합니다.

parent

string

필수 항목입니다. providers/{provider} 형식이어야 합니다. 제공업체는 이 호출을 실행하는 서비스 계정이 구성원인 Google Cloud 프로젝트의 프로젝트 ID (예: sample-cloud-project)여야 합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현

JSON 표현
{ "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`), "filter": string }

{
  "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),
  "filter": string
}

필드
`header`	`object (RequestHeader)` 표준 Fleet Engine 요청 헤더입니다.
`pickupPoint`	`object (TerminalLocation)` 필수 항목입니다. 근처에서 검색할 승차 지점입니다.
`dropoffPoint`	`object (TerminalLocation)` 고객이 의도한 하차 위치입니다. `tripTypes`에 `TripType.SHARED`이 포함된 경우 이 필드는 필수입니다.
`pickupRadiusMeters`	`integer` 필수 항목입니다. 승차 지점 주변의 차량 검색 반경을 정의합니다. 검색 반경 내의 차량만 반환됩니다. 값은 400미터 이상 10,000미터 이하여야 합니다.
`count`	`integer` 필수 항목입니다. 반납할 수 있는 최대 차량 수를 지정합니다. 값은 1 이상 50 이하여야 합니다.
`minimumCapacity`	`integer` 필수 항목입니다. 이동을 위해 고려되는 승객 수를 지정합니다. 값은 1 이상이어야 합니다. 드라이버는 용량 값에 고려되지 않습니다.
`tripTypes[]`	`enum (TripType)` 필수 항목입니다. 제안된 이동의 유형을 나타냅니다. 적격 차량은 지정된 이동 유형 중 하나 이상을 지원할 수 있는 차량입니다. `EXCLUSIVE`와 `SHARED`은 함께 포함할 수 없습니다. `currentTripsPresent`이 `CURRENT_TRIPS_PRESENT_UNSPECIFIED`이면 `SHARED`이(가) 지원되지 않습니다. `UNKNOWN_TRIP_TYPE`은(는) 허용되지 않습니다.
`maximumStaleness`	`string (Duration format)` 지정된 기간 내에 Fleet Engine으로 위치 업데이트를 전송한 차량으로만 검색을 제한합니다. 여전히 위치를 전송하고 있는 정차 차량은 오래된 차량으로 간주되지 않습니다. 이 필드를 설정하지 않으면 서버에서 5분을 기본값으로 사용합니다. 소수점 아래가 최대 9자리까지이고 '`s`'로 끝나는 초 단위 기간입니다. 예를 들면 `"3.5s"`입니다.
`vehicleTypes[]`	`object (VehicleType)` 필수 항목입니다. 지정된 유형 중 하나가 있는 차량으로 검색을 제한합니다. 차량 유형을 하나 이상 지정해야 합니다. `UNKNOWN` 카테고리의 VehicleType은 허용되지 않습니다.
`requiredAttributes[]`	`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 연산입니다. 필수 속성은 최대 50개까지 허용됩니다. 차량에 허용되는 최대 속성 수와 일치합니다.
`requiredOneOfAttributes[]`	`object (VehicleAttributeList)` 각 `VehicleAttributeList`에 지정된 속성을 하나 이상 가진 차량으로만 검색을 제한합니다. 각 목록에서 차량은 속성 중 하나 이상과 일치해야 합니다. 이 필드는 각 `VehicleAttributeList`의 포괄적 분리/OR 연산과 `VehicleAttributeList` 컬렉션 전반의 결합/AND 연산입니다.
`requiredOneOfAttributeSets[]`	`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 연산입니다.
`orderBy`	`enum (VehicleMatchOrder)` 필수 항목입니다. 결과에 대해 원하는 정렬 기준을 지정합니다.
`includeBackToBack`	`boolean` 하나의 이동이 활성화된 차량이 다른 일치 항목의 대상인지 여부를 나타냅니다. `false`인 경우 할당된 이동이 있는 차량이 검색결과에서 제외됩니다. `true`인 경우 검색결과에 `TripStatus`가 `ENROUTE_TO_DROPOFF`인 차량이 포함됩니다. 이 필드는 `EXCLUSIVE`의 단일 `tripType`가 지정된 경우에만 고려됩니다. 기본값은 `false`입니다.
`tripId`	`string` 이 `SearchVehicleRequest`와 연결된 이동을 나타냅니다.
`currentTripsPresent`	`enum (CurrentTripsPresent)` 현재 이동 경로를 기준으로 차량이 검색결과에 표시되지 않도록 제한합니다. currentTripsPresent가 `NONE` 또는 `ANY`인 경우 `tripTypes`는 `EXCLUSIVE` 또는 `SHARED` 중 하나여야 합니다.
`filter`	`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"`).

응답 본문

성공한 경우 응답 본문에 SearchVehiclesResponse의 인스턴스가 포함됩니다.