Method: providers.vehicles.list

요청 옵션과 일치하는 제공업체와 연결된 차량의 페이징된 목록을 반환합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
parent

string

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

쿼리 매개변수

매개변수
header

object (RequestHeader)

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

pageSize

integer

반환할 최대 차량 수입니다. 기본값: 100

pageToken

string

차량 그룹을 통해 페이지를 나눌 수 있도록 이전 vehicles.list 호출에서 제공한 nextPageToken 값입니다. 요청의 필터 기준이 이전 vehicles.list 호출의 필터 기준과 같지 않으면 값이 정의되지 않습니다.

minimumCapacity

integer

차량에 필요한 최소 용량을 지정합니다. 반환된 모든 차량의 maximumCapacity이 이 값보다 크거나 같습니다. 설정하는 경우 0 이상이어야 합니다.

tripTypes[]

enum (TripType)

지정된 이동 유형 중 하나 이상을 지원하는 차량으로 응답을 제한합니다.

maximumStaleness

string (Duration format)

지정된 기간 내에 Fleet Engine에 위치 업데이트를 전송한 차량으로 응답을 제한합니다. 위치를 계속 전송하는 정지된 차량은 비활성 상태로 간주되지 않습니다. 있는 경우 유효한 양수 기간이어야 합니다.

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

vehicleTypeCategories[]

enum (Category)

필수 항목입니다. 지정된 유형 카테고리 중 하나가 있는 차량으로 응답을 제한합니다. UNKNOWN은(는) 허용되지 않습니다.

requiredAttributes[]

string

호출자는 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개까지 허용됩니다. 차량에 허용되는 최대 속성 수와 일치합니다. 반복되는 각 문자열은 '키:값' 형식이어야 합니다.

requiredOneOfAttributes[]

string

VehicleAttributeList에 지정된 속성 중 하나 이상을 가진 차량으로 응답을 제한합니다. 각 목록 내에서 차량은 속성 중 하나 이상과 일치해야 합니다. 이 필드는 각 VehicleAttributeList의 양방향 선택/OR 연산이며 VehicleAttributeList 모음의 결합/AND 연산입니다. 반복되는 각 문자열은 'key1:value1|key2:value2|key3:value3' 형식이어야 합니다.

requiredOneOfAttributeSets[]

string

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 연산입니다. 반복되는 각 문자열은 'key1:value1|key2:value2|key3:value3' 형식이어야 합니다.

vehicleState

enum (VehicleState)

이 차량 상태가 있는 차량에 대한 응답을 제한합니다.

onTripOnly

boolean

현재 이동이 있는 차량만 반환합니다.

filter

string

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

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

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

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

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

viewport

object (Viewport)

선택사항입니다. 마지막으로 알려진 위치가 뷰포트로 정의된 직사각형 영역에 있는 차량으로 반환되는 차량을 제한하는 필터입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

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

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "vehicles": [
    {
      object (Vehicle)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
필드
vehicles[]

object (Vehicle)

요청의 기준과 일치하는 차량입니다. 반환되는 최대 차량 수는 요청의 pageSize 필드에 따라 결정됩니다.

nextPageToken

string

차량의 다음 페이지를 가져오는 토큰이며, 요청 기준을 충족하는 차량이 더 이상 없는 경우 비어 있습니다.

totalSize

string (int64 format)

필수 항목입니다. 모든 페이지에서 요청 기준과 일치하는 총 차량 수입니다.

표시 영역

대각선 반대쪽에 있는 두 개의 lowhigh 지점으로 표시되는 위도-경도 표시 영역입니다. 표시 영역은 경계가 포함된 닫힌 영역으로 간주됩니다. 위도 경계는 -90도 이상 90도 이하로 설정할 수 있으며, 경도는 -180도 이상 180도 이하로 설정할 수 있습니다. 다양한 사례는 다음과 같습니다.

  • low = high이면 뷰포트는 단일 지점으로 구성됩니다.

  • low.longitude > high.longitude이면 경도 범위가 반전됩니다 (표시 영역이 180도 경도 선을 교차함).

  • low.longitude = -180도이고 high.longitude = 180도인 경우 뷰포트에 모든 경도가 포함됩니다.

  • low.longitude = 180도이고 high.longitude = -180도인 경우 경도 범위는 비어 있습니다.

  • low.latitudehigh.latitude보다 크면 위도 범위가 비어 있습니다.

lowhigh 모두 채워야 하며, 위에 정의된 대로 표현된 상자는 비워 둘 수 없습니다. 뷰포트가 비어 있으면 오류가 발생합니다.

예를 들어 이 표시 영역은 뉴욕시를 완전히 둘러쌉니다.

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

JSON 표현
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
필드
low

object (LatLng)

필수 항목입니다. 표시 영역의 낮은 지점입니다.

high

object (LatLng)

필수 항목입니다. 뷰포트의 최고점입니다.