本頁面由 Cloud Translation API 翻譯而成。

搜尋車輛

作為行動隨選行程服務的一部分，你可以尋找附近的車輛透過 SearchVehicles 方法處理這些要求

SearchVehicles 方法可讓您尋找最適合特定乘車或外送服務的消費者行動應用程式請求。SearchVehicles API 會傳回經過排序的車輛清單屬性與要求的行程屬性相符。排名是根據可選擇預計到達時間、距離或直線距離。

搜尋屬性	車輛屬性
上車和下車地點要求的車輛和行程類型所需容量其他必要的比對屬性	車輛的最後已知位置車輛狀態、類型或容量其他自訂屬性

使用 `SearchVehicles` 方法

如要使用 SearchVehicles，請按照以下一般程序操作：

根據要指派的行程建構 SearchVehiclesRequest。
使用下列指令呼叫 SearchVehicles API (vehicleService.searchVehicles) 建構要求
處理 API 傳回的 SearchVehicleResponse。

搜尋 VehiclesRequest 欄位

請使用下列必要屬性欄位建構 SearchVehiclesRequest：

欄位	說明
parent	必填。格式提供者/{provider}。提供者必須為進行呼叫的服務帳戶所屬的 Google Cloud 專案專案 ID。
vehicle_types	必填。要求的車輛類型：AUTO、TWO_WHEELER、TAXI、TRUCK、BICYCLE 或 PEDESTRIAN。
trip_types	必填。「專屬」(每位司機一次一項有效行程) 或「有」共用 (每位司機一次提供一或多個行程)。
minimum_capacity	必填。新行程的車輛總容量 (無論是乘客或外送服務)。
pickup_point	必填。行程的上車地點 (以經緯度座標表示)。
dropoff_point	選用設定。行程的下車地點，以經緯度座標表示。如果行程_types 包含 TripType.SHARED，則此為必填欄位。
pickup_radius_meters	必填。從上車地點的車輛搜尋區域半徑 (以公尺為單位)。
order_by	必填。透過下列其中一種方式訂購車輛： PICKUP_POINT_ETA，也就是車輛在上車地點的預計到達時間。 PICKUP_POINT_DISTANCE，也就是車輛與上車地點之間的距離。 DROPOFF_POINT_ETA，車輛的預計到達時間，完成行程。 PICKUP_POINT_STRAIGHT_DISTANCE 是車輛和上車地點之間的直線距離 (不在路線中)。
數量	必填。可退貨的車輛數量上限 (1 至 50 個)。
篩選器	(選用) 搜尋車輛時要套用的篩選查詢。

如要查看完整的 SearchVehicleRequest (車輛要求) 欄位。

搜尋 VehiclesRequest 情境

本節會舉例說明如何建構 SearchVehiclesRequest。

舉例來說，假設客戶想到 RestaurantX 取貨，你有四輛車

車輛 1：距離 RestaurantX 3500 公尺。
車輛 2：距離餐廳 X 門市 100 公尺，正在搭乘已上車的上車地點並在地點 A 和 B 下車
車輛 3：距離 RestaurantX 200 公尺，只剩 1 輛車
車輛 4：距離 RestaurantX 1000 公尺。

以下顯示了傳回車輛的各種要求。

回程車 4

     Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA

回程車 3 和 4

     Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA, is_back_to_back enabled

傳回車輛 2、3 和 4

     Pickup at RestaurantX, radius = 1200m, order by PICKUP_POINT_ETA, current_trips_present = ALL

搜尋 VehiclesResponse 欄位

SearchVehiclesResponse 包含列出排名的 VehicleMatch 實體透過 SearchVehiclesRequest 中的指定 order_by 屬性來指定。每項 VehicleMatch 實體有下列欄位：

欄位	說明
交通工具	`Vehicle` 物件，包括 car_id 和 `Vehicle` 屬性。
vehicle_pickup_eta	車輛在新行程上車地點的預計到達時間。這是行車的預計到達時間。
vehicle_pickup_distance_meter	車輛和新行程的上車地點之間的距離 (以公尺為單位)。
vehicle_pickup_straight_line_distance_meter	車輛和新行程的上車地點之間的直線距離 (以公尺為單位)。
vehicle_dropoff_eta	時間戳記車輛抵達上車地點的預計到達時間。請注意，預計到達時間就是抵達的預計到達時間。
vehicle_trips_waypoints	目前指派給車輛的有效行程其餘路線控點清單，包括上車和下車地點。
vehicle_match_type	車輛的行程類型，可以是 EXCLUSIVE、BACK_TO_BACK、CARPOOL 或 CARPOOL_BACK_TO_BACK。

如需 VehicleMatch 欄位的完整清單，請參閱：

VehicleMatch message (gRPC)
VehicleMatch resource (REST)

，瞭解如何調查及移除這項存取權。

使用篩選查詢

SearchVehicles 和 ListVehicles 支援篩選車輛屬性使用篩選器查詢。

篩選查詢「僅支援」篩選車輛自訂屬性，以及不得用於其他欄位用於含有其他欄位的搜尋 minimum_capacity 或 vehicle_types 等條件做為 AND 子句使用

舉例來說，假設您搜尋的車輛容量下限為 6 人，篩選 attributes (例如「寵物友善」)，您的條件只會傳回可攜帶寵物且至少有 6 名乘客的車輛。

如需篩選查詢語法，請參閱 AIP-160 。如要進一步瞭解如何建立車輛屬性，請參閱「交通工具」一節屬性欄位請參閱更新車輛欄位指南。

搜尋車輛範例

以下範例顯示如何使用 SearchVehicles API 使用 Java gRPC 程式庫。

static final String PROJECT_ID = "project-id";

VehicleServiceBlockingStub vehicleService =
    VehicleService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;
SearchVehiclesRequest searchVehiclesRequest = SearchVehiclesRequest.newBuilder()
    .setParent(parent)
    .setPickupPoint( // Grand Indonesia East Mall
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
    .setDropoffPoint( // Balai Sidang Jkt Convention Center
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder().setLatitude(-6.213796).setLongitude(106.807195)))
    .setPickupRadiusMeters(2000)
    .setCount(10)
    .setMinimumCapacity(2)
    .addTripTypes(TripType.EXCLUSIVE)
    .addVehicleTypes(VehicleType.newBuilder().setCategory(Category.AUTO).build())
    .setCurrentTripsPresent(CurrentTripsPresent.ANY)
    .setFilter("attributes.on_trip=\"false\"")
    .setOrderBy(VehicleMatchOrder.PICKUP_POINT_ETA)
    .build();

try {
  SearchVehiclesResponse searchVehiclesResponse =
      vehicleService.searchVehicles(searchVehiclesRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

List<VehicleMatch> vehicleMatches =
    searchVehicleResponse.getMatchesList();

// Each VehicleMatch contains a Vehicle entity and information about the
// distance and ETA to the pickup point and drop-off point.

後續步驟

建立隨選行程