요청 옵션과 일치하는 제공업체와 연결된 페이지로 나눈 차량 목록을 반환합니다.
HTTP 요청
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. |
쿼리 매개변수
매개변수 | |
---|---|
header |
표준 Fleet Engine 요청 헤더입니다. |
pageSize |
반납할 수 있는 최대 차량 수입니다. 기본값은 100입니다. |
pageToken |
차량 그룹을 통해 페이지로 나눌 수 있도록 이전 |
minimumCapacity |
차량에 필요한 최소 용량을 지정합니다. 반환되는 모든 차량의 |
tripTypes[] |
지정된 이동 유형 중 하나 이상을 지원하는 차량으로 응답을 제한합니다. |
maximumStaleness |
지정된 기간 내에 Fleet Engine으로 위치 업데이트를 전송한 차량으로 응답을 제한합니다. 여전히 위치를 전송 중인 정차 차량은 오래된 것으로 간주되지 않습니다. 있는 경우 유효한 양수 기간이어야 합니다. 소수점 아래가 최대 9자리까지이고 ' |
vehicleTypeCategories[] |
필수 항목입니다. 지정된 유형 카테고리 중 하나가 있는 차량으로 응답을 제한합니다. |
requiredAttributes[] |
호출자는
지정된 속성이 있는 차량으로 응답을 제한합니다. 이 필드는 결합/AND 연산입니다. 최대 50개의 requiredAttributes가 허용됩니다. 차량에 허용되는 최대 속성 수와 일치합니다. 반복되는 각 문자열은 'key:value' 형식이어야 합니다. |
requiredOneOfAttributes[] |
각 |
requiredOneOfAttributeSets[] |
|
vehicleState |
이 차량 상태의 차량으로 응답을 제한합니다. |
onTripOnly |
현재 이동 중인 차량만 반납하세요. |
filter |
선택사항입니다. 차량을 나열할 때 적용할 필터 쿼리입니다. 필터 구문의 예는 http://aip.dev/160을 참조하세요. 이 필드는 이 필터는 지원되는 유일한 쿼리는 차량 속성 (예: 또한 모든 속성은 문자열로 저장되므로 속성에 대해 지원되는 유일한 비교는 문자열 비교입니다. 숫자 또는 불리언 값과 비교하려면 값을 명시적으로 따옴표로 묶어 문자열로 처리해야 합니다 (예: |
viewport |
선택사항입니다. 마지막으로 알려진 위치가 표시 영역에 정의된 직사각형 영역에 있었던 차량으로 되돌아가는 차량을 제한하는 필터입니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
vehicles.list
응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"vehicles": [
{
object ( |
필드 | |
---|---|
vehicles[] |
요청의 기준과 일치하는 차량입니다. 반환되는 최대 차량 수는 요청의 |
nextPageToken |
차량의 다음 페이지를 가져오는 토큰으로, 요청 기준을 충족하는 차량이 더 이상 없는 경우 비어 있습니다. |
totalSize |
필수 항목입니다. 모든 페이지에서 요청 기준과 일치하는 총 차량 수입니다. |
표시 영역
위도-경도 표시 영역으로, 대각선으로 반대되는 두 개의 low
및 high
지점으로 표시됩니다. 표시 영역은 닫힌 영역으로 간주됩니다. 즉, 경계가 포함된 영역입니다. 위도 경계는 -90도 이상 90도 이하로, 경도 경계는 -180도 이상 180도 이하로 설정할 수 있습니다. 다음과 같은 경우가 다양합니다.
low
=high
인 경우 표시 영역은 단일 점으로 구성됩니다.low.longitude
>high.longitude
이면 경도 범위가 반전됩니다 (표시 영역이 경도 180도 선을 교차함).low.longitude
= -180도,high.longitude
= 180도인 경우 표시 영역에 모든 경도가 포함됩니다.low.longitude
= 180도이고high.longitude
= -180도이면 경도 범위는 비어 있습니다.low.latitude
>high.latitude
이면 위도 범위가 비어 있습니다.
low
와 high
를 모두 입력해야 하며 표시된 상자는 위 정의에서 지정한 대로 비워 둘 수 없습니다. 표시 영역이 비어 있으면 오류가 발생합니다.
예를 들어 다음 표시 영역은 뉴욕시를 완전히 둘러쌉니다.
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
JSON 표현 |
---|
{ "low": { object ( |
필드 | |
---|---|
low |
필수 항목입니다. 표시 영역의 최저점입니다. |
high |
필수 항목입니다. 표시 영역의 최고점입니다. |