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 liên tiếp, đặt các trường chính xác và chỉ định chuyến đi đó cho một xe để thực hiện. Tài liệu này giả định rằng bạn đã thiết lập Công cụ quản lý đội xe, đã tạo xe, có một ứng dụng cho tài xế đang hoạt động và có thể có một ứng dụng cho người tiêu dùng. Bạn cũng nên làm quen với nhiều tình huống 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êm thông tin:

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

Kiến thức 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 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 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: 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 tuỳ chọn khi tạo chuyến đi hoặc có thể đặt các trường đó sau khi cập nhật chuyến đi.

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

Phần sau đây minh hoạ cách tạo một chuyến đi nối tiếp và chỉ định chuyến đi đó cho một phương tiện. Trong trường hợp này, việc tạo chuyến đi cũng giống như đối với chuyến đi có một điểm đến. Chỉ sau đó, bạn mới tạo một chuyến đi khác và chỉ định chuyến đi đó cho một xe đang có chuyến đi đang hoạt động.

// 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 xe cho một chuyến đi liên tiếp, bạn chỉ định một chuyến đi cho một xe ngay cả khi 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 xe để Fleet Engine có thể tính toán thời gian đến dự kiến 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 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 trả khách của chuyến đi.

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

• Khi gọi getVehicle(), hệ thống sẽ trả về remainingWaypoints chứa:
  _{Điểm trả khách} của A → _{Điểm đón khách} của B → _{Điểm trả khách} của B.
• 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 trả về remainingWaypoints chứa:
  _{Điểm trả khách} của chuyến đi A → _{Điểm đón khách} của chuyến đi B → và _{Điểm trả khách} của chuyến đi B.

Bước tiếp theo

• Tạo chuyến đi chung
• Thiết lập SDK Tài xế