ListVehicles
メソッドを使用して、特定のリクエスト オプションを満たすすべての車両を検索します。ListVehicles
メソッドは、車両フィールド全体のクエリに一致する、プロジェクト内の車両のページネーション リストを返します。
車両属性でフィルタする
このメソッドを使用して、車両属性でフィルタリングすることもできます。この属性は、他のフィールド仕様と組み合わせて使用すると AND 演算子として機能します。フィルタクエリの構文の詳細については、フィルタリング: AIP-160 の例をご覧ください。車両属性の作成について詳しくは、車両フィールドを更新するガイドの車両属性フィールドをご覧ください。
車両の一覧表示の例
この例では、filter
文字列を使用して vehicle_type
フィールドと attributes
フィールドの両方をフィルタし、AUTO タイプの車両のみを表示し、class
のカスタム属性の LUXURY 値を取得します。
Java
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