Tìm xe

Trong dịch vụ chuyến đi theo yêu cầu của Mobility, bạn có thể tìm thấy các phương tiện ở gần bằng phương thức SearchVehicles.

Phương thức SearchVehicles cho phép bạn tìm thấy các phương tiện ở gần hiện có trong ứng dụng di động dành cho người tiêu dùng, phù hợp nhất với một chuyến đi cụ thể hoặc yêu cầu giao hàng. API SearchVehicles trả về danh sách các phương tiện được xếp hạng có thuộc tính khớp với thuộc tính của chuyến đi được yêu cầu. Thứ hạng được sắp xếp theo lựa chọn của bạn về thời gian đến dự kiến (ETA), khoảng cách hoặc khoảng cách đường thẳng từ điểm đón.

Sử dụng phương thức SearchVehicles

Để sử dụng SearchVehicles, hãy làm theo quy trình chung sau:

1. Tạo một SearchVehiclesRequest dựa trên chuyến đi cần chỉ định.
2. Gọi API SearchVehicles (vehicleService.searchVehicles) bằng yêu cầu đã tạo.
3. Xử lý SearchVehicleResponse do API trả về.

Trường SearchVehiclesRequest

Sử dụng các trường thuộc tính bắt buộc sau đây để tạo SearchVehiclesRequest:

Hãy tham khảo tài liệu tham khảo để xem toàn bộ tập hợp các trường SearchVehicleRequest.

Các trường hợp SearchVehiclesRequest

Phần này trình bày các ví dụ về cách tạo SearchVehiclesRequest.

Ví dụ: giả sử một khách hàng muốn được đón tại Nhà hàng X và bạn có 4 chiếc xe:

• Xe 1: cách Nhà hàng X 3500 m.
• Xe 2: cách Nhà hàng X 100 m, có một chuyến đi đang hoạt động với điểm đón và trả khách tại vị trí A và B.
• Xe 3: cách Nhà hàng X 200 m, có một điểm trả khách còn lại ở rất xa.
• Xe 4: cách Nhà hàng X 1000 m.

Sau đây là các yêu cầu khác nhau theo xe mà chúng trả về.

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

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

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

Trường SearchVehiclesResponse

SearchVehiclesResponse bao gồm một danh sách các thực thể VehicleMatch, được xếp hạng theo thuộc tính order_by đã chỉ định trong SearchVehiclesRequest. Mỗi thực thể VehicleMatch có các trường sau:

Để xem danh sách đầy đủ các trường VehicleMatch, hãy xem:

• VehicleMatch message (gRPC)
• VehicleMatch resource (REST)

Sử dụng truy vấn bộ lọc

SearchVehicles và ListVehicles hỗ trợ lọc các thuộc tính xe bằng truy vấn bộ lọc.

Truy vấn bộ lọc CHỈ hỗ trợ lọc các thuộc tính tuỳ chỉnh cho xe và không thể dùng cho các trường khác. Khi được dùng trong một nội dung tìm kiếm có chứa các tiêu chí trường khác, chẳng hạn như minimum_capacity hoặc vehicle_types, truy vấn bộ lọc sẽ hoạt động như một mệnh đề AND.

Ví dụ: nếu bạn tìm kiếm một chiếc xe có sức chứa tối thiểu là 6 và lọc một attributes như thân thiện với thú cưng, thì tiêu chí của bạn sẽ chỉ trả về những chiếc xe vừa thân thiện với thú cưng vừa có thể chở ít nhất 6 hành khách.

Để biết cú pháp truy vấn bộ lọc, hãy xem AIP-160 để biết các ví dụ. Để biết thông tin chi tiết về cách tạo thuộc tính xe, hãy xem Thuộc tính xe trong hướng dẫn Cập nhật trường xe.

Ví dụ về SearchVehicles

Ví dụ sau đây cho biết cách sử dụng API SearchVehicles bằng thư viện gRPC Java. Để xem danh sách đầy đủ các ngôn ngữ được hỗ trợ, hãy xem Thư viện ứng dụng cho các dịch vụ chuyến đi theo yêu cầu.

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.

Bước tiếp theo

• DeleteVehicle