Tạo các chuyến đi liên tiếp

Tài liệu này mô tả cách tạo một chuyến đi khứ hồi, đặt các trường chính xác và chỉ định chuyến đi đó cho một xe để thực hiện. Giả sử bạn đã thiết lập Fleet Engine, đã tạo xe, có một ứng dụng dành cho tài xế đang hoạt động và tuỳ chọn là một ứng dụng dành cho người tiêu dùng. Bạn cũng nên làm quen với nhiều trường hợp chuyến đi có sẵn cho các chuyến đi theo yêu cầu. Hãy xem các hướng dẫn liên quan sau đây để biết thông tin về vấn đề đó:

• Thiết lập Fleet Engine
• Tạo xe
• Các trường hợp đi xe trong phần tổng quan về Chuyến đi theo yêu cầu

Thông tin cơ bản về cách tạo chuyến đi

Phần này mô tả thông tin chi tiết về yêu cầu cần thiết để tạo một chuyến đi trong Fleet Engine. Bạn đưa ra yêu cầu tạo bằng gRPC và REST.

• Phương thức CreateTrip(): gRPC hoặc REST
• Thông báo CreateTripRequest: Chỉ gRPC

Trường chuyến đi

Sử dụng các trường sau để tạo một chuyến đi trong Fleet Engine. Bạn có thể sử dụng các trường khác nhau cho nhiều loại chuyến đi: một hoặc nhiều điểm đến, chuyến đi liên tiếp hoặc chuyến đi chung. Bạn có thể cung cấp các trường không bắt buộc khi tạo chuyến đi hoặc bạn có thể đặt các trường này sau khi cập nhật chuyến đi.

Ví dụ: tạo một chuyến đi liên tiếp

Ví dụ sau đây minh hoạ cách tạo một chuyến đi liên tiếp và chỉ định chuyến đi đó cho một chiếc xe. Trong trường hợp này, cách tạo chuyến đi cũng giống như cách tạo chuyến đi có một điểm đến. Sau đó, bạn mới tạo một chuyến đi khác và chỉ định chuyến đi đó cho một chiếc xe đang có chuyến đi.

// A vehicle with ID 'my-vehicle' is already created and it is assigned to a trip with ID 'current-trip'.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String VEHICLE_ID =" my-vehicle";
static final String TRIP_ID = "back-to-back-trip");

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;

Trip trip = Trip.newBuilder()
    .setTripType(TripType.EXCLUSIVE)
    .setPickupPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.195139).setLongitude(106.820826)))
    .setDropoffPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.1275).setLongitude(106.6537)))
    .setVehicleId(VEHICLE_ID)
    .build();

// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
    .setParent(parent)
    .setTripId(TRIP_ID)
    .setTrip(trip)
    .build();

// Error handling.
try {
  // Fleet Engine automatically assigns a 'waypoints' list to the trip containing
  // the vehicle's current trip waypoints.
  Trip createdTrip =
      tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

Cập nhật các chuyến đi liên tiếp

Khi chỉ định một chiếc xe cho chuyến đi liên tiếp, bạn sẽ chỉ định một chuyến đi cho một chiếc xe ngay cả khi chiếc xe đó đã được chỉ định một chuyến đi.

Mọi chuyến đi được tạo trong Fleet Engine đều phải được chỉ định cho một chiếc xe để Fleet Engine có thể tính toán thời gian dự kiến đến (ETA) của chuyến đi và theo dõi chuyến đi đó. Bạn có thể thực hiện việc này trong quá trình tạo chuyến đi hoặc sau đó khi cập nhật chuyến đi.

Sau khi bạn chỉ định chuyến đi cho một xe, Fleet Engine sẽ tự động thêm các điểm tham chiếu liên kết với các chuyến đi liên tiếp vào trường điểm tham chiếu của xe. Trường remainingWaypoints của một chuyến đi chứa danh sách tất cả các điểm tham chiếu, bao gồm cả những điểm tham chiếu của các chuyến đi khác sẽ được ghé thăm trước khi đến điểm trả khách của chuyến đi.

Ví dụ: hãy xem xét 2 chuyến đi liên tiếp: Chuyến đi A và Chuyến đi B. Xe đã đón người tiêu dùng cho Chuyến đi A và trong khi đang trên đường đến địa điểm trả khách, người lái xe nhận được yêu cầu đón một người tiêu dùng khác cho chuyến đi tiếp theo, Chuyến đi B.

• Việc gọi getVehicle() sẽ trả về remainingWaypoints chứa:
  A _Drop-off → B _Pickup → B _Drop-off.
• Lệnh gọi lại getTrip() hoặc onTripRemainingWaypointsUpdated cho Chuyến đi A trả về remainingWaypoints chứa:
  _{Điểm trả khách}.
• getTrip() hoặc lệnh gọi lại onTripRemainingWaypointsUpdated cho Chuyến đi B đều trả về remainingWaypoints chứa:
  Điểm _{trả khách} → Điểm _{đón khách} → và Điểm _{trả khách}.

Bước tiếp theo

• Tạo chuyến đi ghép xe dùng chung
• Thiết lập Driver SDK