요청 옵션과 일치하는 제공업체와 연결된 차량의 페이징된 목록을 반환합니다.
HTTP 요청
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. |
쿼리 매개변수
매개변수 | |
---|---|
header |
표준 Fleet Engine 요청 헤더입니다. |
page |
반환할 최대 차량 수입니다. 기본값: 100 |
page |
차량 그룹을 통해 페이지를 나눌 수 있도록 이전 |
minimum |
차량에 필요한 최소 용량을 지정합니다. 반환된 모든 차량의 |
trip |
지정된 이동 유형 중 하나 이상을 지원하는 차량으로 응답을 제한합니다. |
maximum |
지정된 기간 내에 Fleet Engine에 위치 업데이트를 전송한 차량으로 응답을 제한합니다. 위치를 계속 전송하는 정지된 차량은 비활성 상태로 간주되지 않습니다. 있는 경우 유효한 양수 기간이어야 합니다. 소수점 아래가 최대 9자리까지이고 ' |
vehicle |
필수 항목입니다. 지정된 유형 카테고리 중 하나가 있는 차량으로 응답을 제한합니다. |
required |
호출자는
지정된 속성을 가진 차량으로 응답을 제한합니다. 이 필드는 결합/AND 연산입니다. requiredAttributes는 최대 50개까지 허용됩니다. 차량에 허용되는 최대 속성 수와 일치합니다. 반복되는 각 문자열은 '키:값' 형식이어야 합니다. |
required |
각 |
required |
|
vehicle |
이 차량 상태가 있는 차량에 대한 응답을 제한합니다. |
on |
현재 이동이 있는 차량만 반환합니다. |
filter |
선택사항입니다. 차량을 나열할 때 적용할 필터 쿼리입니다. 필터 문법의 예는 http://aip.dev/160을 참고하세요. 이 필드는 이 필터는 지원되는 유일한 쿼리는 차량 속성 (예: 또한 모든 속성은 문자열로 저장되므로 속성에 대해 지원되는 유일한 비교는 문자열 비교입니다. 숫자 또는 불리언 값과 비교하려면 값을 명시적으로 따옴표로 묶어 문자열로 처리해야 합니다 (예: |
viewport |
선택사항입니다. 마지막으로 알려진 위치가 뷰포트로 정의된 직사각형 영역에 있는 차량으로 반환되는 차량을 제한하는 필터입니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
vehicles.list
응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"vehicles": [
{
object ( |
필드 | |
---|---|
vehicles[] |
요청의 기준과 일치하는 차량입니다. 반환되는 최대 차량 수는 요청의 |
next |
차량의 다음 페이지를 가져오는 토큰이며, 요청 기준을 충족하는 차량이 더 이상 없는 경우 비어 있습니다. |
total |
필수 항목입니다. 모든 페이지에서 요청 기준과 일치하는 총 차량 수입니다. |
표시 영역
대각선 반대쪽에 있는 두 개의 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 |
필수 항목입니다. 뷰포트의 최고점입니다. |