ListVehicles
메서드를 사용하여 특정 요청 옵션을 충족하는 모든 차량을 찾습니다. ListVehicles
메서드는 차량 필드에서 쿼리와 일치하는 프로젝트의 차량 목록을 페이지로 나눈 목록으로 반환합니다.
차량 속성별로 필터링
이 메서드를 사용하여 차량 속성을 필터링할 수도 있습니다. 이 속성은 다른 필드 사양과 함께 사용될 때 AND 연산자로 작동합니다. 필터 쿼리 문법에 관한 자세한 내용은 예시를 보려면 필터링: AIP-160을 참고하세요. 차량 속성 만들기에 관한 자세한 내용은 차량 입력란 업데이트 가이드의 차량 속성 입력란을 참고하세요.
차량 목록 예시
이 예에서는 filter
문자열을 사용하여 vehicle_type
및 attributes
필드를 모두 필터링하여 AUTO 유형의 차량만 표시하고 class
의 맞춤 속성에 대한 LUXURY 값을 가져옵니다.
자바
static final String PROJECT_ID = "project-id";
VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
ListVehiclesRequest listVehiclesRequest = ListVehiclesRequest.newBuilder()
.setParent(parent)
.addTripTypes(TripType.EXCLUSIVE)
.addVehicleTypes(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
.setFilter("attributes.on_trip=\"false\"")
.setIncludeBackToBack(true) // Fleet Engine includes vehicles that are en route.
.build();
// Error handling
// If matches are returned and the authentication passed, the request completed
// successfully
try {
ListVehiclesResponse listVehiclesResponse =
vehicleService.listVehicles(listVehiclesRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND:
break;
case PERMISSION_DENIED:
break;
}
return;
}
REST
curl -X POST \
"https://fleetengine.googleapis.com/v1/providers/project-id/vehicles:list" \
-H "Authorization: Bearer $JWT" \
-H "Content-Type: application/json" \
--data-binary @- << EOM
{
"vehicleTypes": [{"category": "AUTO"}],
"filter": "attributes.class=\"LUXURY\"",
}
EOM