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

Tài liệu này mô tả cách tạo 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. Phần này giả định bạn đã thiết lập Fleet Engine, bạn đã tạo phương tiện, có một ứng dụng lái xe hoạt động và không bắt buộc là một ứng dụng dành cho người dùng. Bạn cũng nên nắm rõ các tình huống chuyến đi có sẵn cho những chuyến đi theo yêu cầu. Hãy xem các hướng dẫn liên quan sau đây để biết cách khắc phục:

• Thiết lập Fleet Engine
• Tạo xe
• Tình huống chuyến đi 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
• CreateTripRequest thông báo: chỉ dành cho 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 các loại chuyến đi khác nhau: chuyến đi một hoặc nhiều điểm đến, chuyến đi quay lại hoặc chuyến đi gộp 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 có thể thiết lập các trường đó sau khi cập nhật chuyến đi.

Ví dụ: tạo chuyến đi khứ hồi

Phần sau đây minh hoạ cách tạo một chuyến đi hai chiều và chỉ định chuyến đi đó cho một xe. 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 đích đến. 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 phương tiện cho một chuyến đi khứ hồi, bạn sẽ chỉ định một chuyến đi cho một phương tiện ngay cả khi phương tiện đó đã được chỉ định.

Mọi chuyến đi được tạo trong Công cụ quản lý đội xe đều phải được chỉ định cho một xe để Công cụ quản lý đội xe có thể tính toán và theo dõi thời gian đến dự kiến của 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 này khi cập nhật chuyến đi.

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

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

• Việc gọi getVehicle() sẽ trả về remainingWaypoints chứa:
  A _{Điểm trả hàng} → B _{Điểm lấy hàng} → B _{Điểm trả hàng}.
• getTrip() hoặc lệnh gọi lại onTripRemainingWaypointsUpdated cho Chuyến đi A sẽ trả về remainingWaypoints chứa:
  Một _{đ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:
  A _{Trả khách} → B _{Đến lấy hàng} → và B _{Trả khách}.

Bước tiếp theo

• Tạo chuyến đi chung
• Thiết lập SDK trình điều khiển