শেয়ার্ড পুলিং ট্রিপ তৈরি করুন

এই ডকুমেন্টটিতে বর্ণনা করা হয়েছে কীভাবে একটি শেয়ার্ড পুলিং ট্রিপ তৈরি করতে হয়, সঠিক ফিল্ডগুলো সেট করতে হয় এবং তা সম্পন্ন করার জন্য একটি যানবাহনকে বরাদ্দ করতে হয়। এটি ধরে নেয় যে আপনি ফ্লিট ইঞ্জিন সেট আপ করেছেন, যানবাহন তৈরি করেছেন, আপনার একটি কার্যকর ড্রাইভার অ্যাপ এবং ঐচ্ছিকভাবে, একটি কনজিউমার অ্যাপ রয়েছে। অন-ডিমান্ড ট্রিপের জন্য উপলব্ধ বিভিন্ন ট্রিপ সিনারিও সম্পর্কেও আপনার পরিচিতি থাকা উচিত। এর জন্য নিম্নলিখিত সম্পর্কিত গাইডগুলো দেখুন:

ট্রিপ তৈরির প্রাথমিক বিষয়াবলী

এই বিভাগে ফ্লিট ইঞ্জিনে একটি ট্রিপ তৈরি করার জন্য প্রয়োজনীয় অনুরোধের বিবরণ বর্ণনা করা হয়েছে। আপনি gRPC এবং REST ব্যবহার করে একটি তৈরির অনুরোধ পাঠাতে পারেন।

  • CreateTrip() মেথড: gRPC অথবা REST
  • CreateTripRequest বার্তা: শুধুমাত্র gRPC

ট্রিপ ফিল্ডস

ফ্লিট ইঞ্জিনে একটি ট্রিপ তৈরি করতে নিম্নলিখিত ফিল্ডগুলো ব্যবহার করুন। আপনি বিভিন্ন ধরণের ট্রিপের জন্য ভিন্ন ভিন্ন ফিল্ড ব্যবহার করতে পারেন: একক- বা একাধিক-গন্তব্য, পরপর, বা শেয়ার্ড পুলিং ট্রিপ। ট্রিপ তৈরি করার সময় আপনি ঐচ্ছিক ফিল্ডগুলো সরবরাহ করতে পারেন, অথবা পরে ট্রিপ আপডেট করার সময় সেগুলো সেট করতে পারেন।

ভ্রমণের ক্ষেত্র
নাম প্রয়োজন? বর্ণনা
অভিভাবক হ্যাঁ একটি স্ট্রিং যাতে প্রজেক্ট আইডি অন্তর্ভুক্ত থাকে। এই আইডিটি অবশ্যই আপনার সম্পূর্ণ ফ্লিট ইঞ্জিন ইন্টিগ্রেশন জুড়ে একই সার্ভিস অ্যাকাউন্ট রোলের জন্য ব্যবহৃত আইডি হতে হবে।
ট্রিপ_আইডি হ্যাঁ আপনার তৈরি করা একটি স্ট্রিং যা এই ট্রিপটিকে অনন্যভাবে শনাক্ত করে। রেফারেন্সে যেমন উল্লেখ করা হয়েছে, ট্রিপ আইডিগুলোর কিছু নির্দিষ্ট সীমাবদ্ধতা রয়েছে।
ভ্রমণের ধরণ হ্যাঁ আপনি যে ট্রিপ টাইপটি তৈরি করছেন, তার জন্য TripType-কে নিম্নলিখিত মানগুলিতে সেট করুন:
  • একক গন্তব্য : SHARED বা EXCLUSIVE হিসেবে সেট করুন।
  • একাধিক গন্তব্য : EXCLUSIVE এ সেট করা হয়েছে।
  • পরপর : EXCLUSIVE হিসেবে সেট করা হয়েছে।
  • শেয়ার্ড পুলিং : SHARED এ সেট করুন।
পিকআপ_পয়েন্ট হ্যাঁ যাত্রাটির উৎসস্থল।
মধ্যবর্তী গন্তব্যস্থল হ্যাঁ

শুধুমাত্র একাধিক গন্তব্যের ট্রিপের জন্য : পিকআপ এবং ড্রপ-অফের মাঝে ড্রাইভার যেসব মধ্যবর্তী গন্তব্যে যান, তার তালিকা। dropoff_point এর মতোই, এই ফিল্ডটিও UpdateTrip কল করে পরে সেট করা যেতে পারে, কিন্তু সংজ্ঞানুসারে একটি একাধিক গন্তব্যের ট্রিপে মধ্যবর্তী গন্তব্য অন্তর্ভুক্ত থাকে।

যানবাহন_ওয়েপয়েন্ট হ্যাঁ

শুধুমাত্র শেয়ার্ড-পুলিং ট্রিপের জন্য : এই ফিল্ডটি একাধিক ট্রিপের ওয়েপয়েন্টগুলোকে একসাথে সাজানো সমর্থন করে। এতে নির্ধারিত গাড়ির জন্য বাকি থাকা সমস্ত ওয়েপয়েন্ট, সেইসাথে এই ট্রিপের পিকআপ এবং ড্রপ-অফ ওয়েপয়েন্টগুলো থাকে। আপনি CreateTrip বা UpdateTrip কল করে এই ফিল্ডটি সেট করতে পারেন। এছাড়াও, আপনি UpdateVehicle কল করে waypoints ফিল্ডের মাধ্যমে গাড়ির ওয়েপয়েন্টগুলো আপডেট করতে পারেন। গোপনীয়তার কারণে, সার্ভিসটি GetTrip কলে এই তথ্য ফেরত দেয় না।

যাত্রীর সংখ্যা না যাত্রাপথে যাত্রীর সংখ্যা।
ড্রপঅফ_পয়েন্ট না ভ্রমণের গন্তব্য।
গাড়ির_আইডি না ট্রিপের জন্য বরাদ্দকৃত যানবাহনটির আইডি।

উদাহরণ: একটি যৌথ পুলিং ট্রিপ তৈরি করুন

নিম্নলিখিত ব্যাকএন্ড ইন্টিগ্রেশন নমুনাটি দেখায় কিভাবে একটি ট্রিপ তৈরি করতে হয় এবং সেটিকে একটি শেয়ার্ড-পুলিং ট্রিপ হিসাবে একটি যানবাহনে বরাদ্দ করতে হয়।

// Vehicle with VEHICLE_ID ID is already created and it is assigned Trip A.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "shared-trip-A";
static final String VEHICLE_ID = "your-vehicle-id";
static final String TRIP_A_ID = "trip-a-id";
static final String TRIP_B_ID = "trip-b-id";

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;

LatLng tripBPickup =
    LatLng.newBuilder().setLatitude(-12.12314).setLongitude(88.142123).build();
LatLng tripBDropoff =
    LatLng.newBuilder().setLatitude(-14.12314).setLongitude(90.142123).build();

TerminalLocation tripBPickupTerminalLocation =
    TerminalLocation.newBuilder().setPoint(tripBPickup).build();
TerminalLocation tripBDropoffTerminalLocation =
    TerminalLocation.newBuilder().setPoint(tripBDropoff).build();

// TripA already exists and it's assigned to a vehicle with VEHICLE_ID ID.
Trip tripB = Trip.newBuilder()
    .setTripType(TripType.SHARED)
    .setVehicleId(VEHICLE_ID)
    .setPickupPoint(tripBPickupTerminalLocation)
    .setDropoffPoint(tripBDropoffTerminalLocation)
    .addAllVehicleWaypoints(
        // This is where you define the arrival order for unvisited waypoints.
        // If you don't specify an order, then the Fleet Engine adds Trip B's
        // waypoints to the end of Trip A's.
        ImmutableList.of(
            // Trip B's pickup point.
            TripWaypoint.newBuilder()
                .setLocation(tripBPickupTerminalLocation)
                .setTripId(TRIP_B_ID)
                .setWaypointType(WaypointType.PICKUP_WAYPOINT_TYPE)
                .build(),
            // Trip A's drop-off point.
            TripWaypoint.newBuilder()
                .setLocation(tripA.getDropoffPoint())
                .setTripId(TRIP_A_ID)
                .setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
                .build(),
            // Trip B's drop-off point.
            TripWaypoint.newBuilder()
                .setLocation(tripBDropoffTerminalLocation)
                .setTripId(TRIP_B_ID)
                .setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
                .build()))
    .build();

// Create Trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
    .setParent(parent)
    .setTripId(TRIP_B_ID)
    .setTrip(tripB)
    .build();

try {
  // createdTrip.remainingWaypoints will contain shared-pool waypoints.
  // [tripB.pickup, tripA.dropoff, tripB.dropoff]
  Trip createdTrip = tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

শেয়ার্ড পুলিং ট্রিপ আপডেট করুন

ফ্লিট ইঞ্জিনে তৈরি করা যেকোনো ট্রিপকে অবশ্যই একটি গাড়ির সাথে যুক্ত করতে হবে, যাতে ফ্লিট ইঞ্জিন ট্রিপের আনুমানিক পৌঁছানোর সময় (ETA) গণনা করতে ও সেটির ট্র্যাক রাখতে পারে। আপনি ট্রিপ তৈরির সময় অথবা পরে ট্রিপটি আপডেট করার সময় এই কাজটি করতে পারেন।

শেয়ার্ড পুলিং ট্রিপের ক্ষেত্রে, আপনাকে অবশ্যই ট্রিপের ভেহিকেল ওয়েপয়েন্টের সংগ্রহে ( Trip.vehicle_waypoints ) থাকা অপরিদর্শিত ওয়েপয়েন্টগুলোর একটি ক্রম নির্দিষ্ট করে দিতে হবে। ফ্লিট ইঞ্জিন এই তালিকাটি ব্যবহার করে শেয়ার্ড-পুলে থাকা সমস্ত ট্রিপের ওয়েপয়েন্টগুলো স্বয়ংক্রিয়ভাবে আপডেট করে।

উদাহরণস্বরূপ, শেয়ার্ড-পুলে করা দুটি ভ্রমণ, ভ্রমণ A এবং ভ্রমণ B বিবেচনা করুন:

  • ট্রিপ ‘এ’ তার গন্তব্যে পৌঁছানোর পথে রয়েছে।
  • এরপর ট্রিপ বি একই যানবাহনে যুক্ত করা হয়।

ট্রিপ B- এর একটি UpdateTripRequest এ, আপনি vehicleId সেট করেন এবং Trip.vehicle_waypoints সর্বোত্তম ওয়েপয়েন্ট ক্রমে সেট করেন: B পিকআপ → A ড্রপ-অফ → B ড্রপ-অফ ।

  • getVehicle() কল করলে remainingWaypoints ফেরত আসে, যেগুলোতে থাকে:
    বি পিকআপ → এ ড্রপ-অফ → বি ড্রপ-অফ ।
  • ট্রিপ A- এর জন্য getTrip() অথবা onTripRemainingWaypointsUpdated কলব্যাকটি remainingWaypoints রিটার্ন করে, যেগুলোতে নিম্নলিখিত বিষয়গুলো থাকে:
    B পিকআপ → A ড্রপ-অফ ।
  • ট্রিপ B- এর জন্য getTrip() অথবা onTripRemainingWaypointsUpdated কলব্যাকটি remainingWaypoints রিটার্ন করে, যেগুলোতে নিম্নলিখিত বিষয়গুলো থাকে:
    বি পিকআপ → এ ড্রপ-অফ → বি ড্রপ-অফ ।

উদাহরণ

নিম্নলিখিত ব্যাকএন্ড ইন্টিগ্রেশন নমুনাটি দেখায় কিভাবে দুটি শেয়ার্ড-পুল ট্রিপের জন্য গাড়ির আইডি এবং ওয়েপয়েন্ট ব্যবহার করে একটি ট্রিপ আপডেট করতে হয়।

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_A_ID = "share-trip-A";
static final String TRIP_B_ID = "share-trip-B";
static final String VEHICLE_ID = "Vehicle";

String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_B_ID;

// Get Trip A and Trip B objects from either the Fleet Engine or storage.
Trip tripA = …;
Trip tripB = …;

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// The trip settings to update.
Trip trip = Trip.newBuilder()
    .setVehicleId(VEHICLE_ID)
    .addAllVehicleWaypoints(
        // This is where you define the arrival order for unvisited waypoints.
        // If you don't specify an order, then the Fleet Engine adds Trip B's
        // waypoints to the end of Trip A's.
        ImmutableList.of(
            // Trip B's pickup point.
            TripWaypoint.newBuilder()
                .setLocation(tripB.getPickupPoint())
                .setTripId(TRIP_B_ID)
                .setWaypointType(WaypointType.PICKUP_WAYPOINT_TYPE)
                .build(),
            // Trip A's drop-off point.
            TripWaypoint.newBuilder()
                .setLocation(tripA.getDropoffPoint())
                .setTripId(TRIP_A_ID)
                .setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
                .build(),
            // Trip B's drop-off point.
            TripWaypoint.newBuilder()
                .setLocation(tripB.getDropoffPoint())
                .setTripId(TRIP_B_ID)
                .setWaypointType(WaypointType.DROP_OFF_WAYPOINT_TYPE)
                .build()))
    .build();

// The trip update request.
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
    .setName(tripName)
    .setTrip(trip)
    .setUpdateMask(FieldMask.newBuilder()
        .addPaths("vehicle_id")
        .addPaths("vehicle_waypoints"))
    .build();

// Error handling. If Fleet Engine has both a trip and vehicle with the IDs,
// and if the credentials validate, and if the given vehicle_waypoints list
// is valid, then the service updates the trip.
try {
  Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:          // Either the trip or vehicle does not exist.
      break;
    case PERMISSION_DENIED:
      break;
    case INVALID_REQUEST:    // vehicle_waypoints is invalid.
      break;
  }
  return;
}

এরপর কী?