Đang tìm người lái xe ở gần

Nằm trong giải pháp gọi xe và giao hàng theo yêu cầu của bạn, công cụ Lập kế hoạch và điều phối tuyến đường cho phép bạn tìm trình điều khiển lân cận bằng cách cung cấp API SearchVehicles.

API SearchVehicles cho phép bạn tìm thấy các trình điều khiển lân cận trong Ứng dụng dành cho người tiêu dùng Giải pháp gọi xe và giao hàng theo yêu cầu phù hợp nhất cho một công việc chẳng hạn như gọi xe hoặc yêu cầu giao hàng. API SearchVehicles trả về một danh sách xếp hạng trình điều khiển phù hợp với các thuộc tính nhiệm vụ với thuộc tính phương tiện trong đội phương tiện vận chuyển của bạn.

Các thuộc tính của việc cần làm có thể bao gồm:

• Địa điểm nhận và trả xe
• Loại chuyến đi và phương tiện được yêu cầu
• Dung lượng bắt buộc
• Các thuộc tính so khớp bắt buộc khác

Các thuộc tính về xe có thể bao gồm:

• Vị trí xác định gần đây nhất của một chiếc xe
• Trạng thái, loại hoặc sức chứa của xe
• Các thuộc tính tuỳ chỉnh khác

Thứ hạng được sắp xếp theo giờ đến dự kiến, khoảng cách hoặc đường thẳng khoảng cách từ điểm đón.

Lưu ý: Bạn phải có Người dùng cao cấp hoặc Người dùng SDK tiêu dùng của Fleet Engine Service để sử dụng API SearchVehicles. Để biết thêm thông tin, hãy xem Xác thực và uỷ quyền.

Sử dụng API Searchvehicles

Cách sử dụng API SearchVehicles:

• Tạo SearchVehiclesRequest dựa trên việc cần làm được giao.
• Gọi API SearchVehicles (vehicleService.searchVehicles) với yêu cầu đã tạo.
• 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 toàn bộ SearchVehicleRequestfields.

Ví dụ về SearchvehiclesRequest

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

Ví dụ: giả sử bạn có một nhiệm vụ đến lấy hàng cần giao tại RestaurantX và 4 xe:

• Xe 1, cách RestaurantX 3500 m.
• Xe 2, cách RestaurantX 100 m và có một chuyến đi đang diễn ra bằng cách nhận và trả khách tại vị trí A và B.
• Xe 3, cách RestaurantX 200m và còn một chỗ đỗ xe rất xa.
• Xe 4, cách RestaurantX 1.000 m.

SearchVehiclesRequest sau đây trả về Xe 4:

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

SearchVehiclesRequest sau đây trả về Xe 3 và 4:

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

SearchVehiclesRequest sau đây trả về Xe 2, 3 và 4:

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

Các 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 (theo thứ tự) được chỉ định trong SearchVehiclesRequest. Mỗi thực thể VehicleMatch có các trường sau:

Ví dụ về SearchXes

Ví dụ sau đây trình bày cách sử dụng API SearchVehicles:

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.