Tìm xe

Trong dịch vụ di chuyển theo yêu cầu về di chuyển, bạn có thể tìm thấy các xe ở gần bằng cách sử dụng phương thức SearchVehicles.

Phương thức SearchVehicles cho phép bạn tìm các xe hiện có ở gần 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 hoặc dịch vụ giao hàng cụ thể yêu cầu. API SearchVehicles trả về danh sách các xe được xếp hạng có thuộc tính khớp với thuộc tính 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, khoảng cách hoặc khoảng cách theo đường thẳng từ điểm đến lấy hàng.

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 được trả về từ API.

Các trường SearchVehiclesRequest

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

Hãy tham khảo Tài liệu tham khảo để xem bộ đầy đủ các trường SearchVehicleRequest.

Tình huống SearchXesRequest

Phần này trình bày 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 xe:

• Xe 1: Cách Nhà hàng X 3.500 m.
• Xe 2: Cách Nhà hàng X 100 m, đang 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 RestaurantX 200 m, còn lại một trạm dừng chân ở rất xa.
• Xe 4: Cách RestaurantX 1000m.

Phần sau đây cho thấy nhiều yêu cầu theo chiếc xe mà khách hàng trả lại.

     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
    

Các trường SearchVehiclesResponse

Một SearchVehiclesResponse bao gồm một danh sách gồm các thực thể VehicleMatch, được xếp hạng theo thuộc tính order_by (theo thứ tự) được 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 lọc

SearchVehicles và ListVehicles hỗ trợ lọc theo các thuộc tính xe bằng cách sử dụng cụm từ tìm kiếm bộ lọc.

Truy vấn bộ lọc CHỈ hỗ trợ lọc theo 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 nội dung tìm kiếm bao gồm trường khác tiêu chí, chẳng hạn như minimum_capacity hoặc vehicle_types, truy vấn lọc có hàm dưới dạng 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 người và lọc một attributes như cho phép mang theo thú cưng, thì tiêu chí của bạn sẽ chỉ trả về những chiếc xe vừa cho phép mang theo thú cưng vừa có thể chở ít nhất 6 người.

Đối với cú pháp truy vấn bộ lọc, hãy xem AIP-160 để có 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 Trường thuộc tính xe trong hướng dẫn Cập nhật các trường xe.

Ví dụ về Searchvehicles

Ví dụ sau đây trình bày cách dùng API SearchVehicles trong Thư viện 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.

Các bước tiếp theo

• Tạo chuyến đi theo yêu cầu