একটি একক-গন্তব্য ট্রিপ তৈরি করুন

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

ট্রিপ তৈরির মূল বিষয়গুলি

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

  • CreateTrip() পদ্ধতি: gRPC অথবা REST
  • CreateTripRequest বার্তা: শুধুমাত্র gRPC

ভ্রমণ ক্ষেত্র

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

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

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

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

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

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

উদাহরণ: একক গন্তব্যস্থলে ভ্রমণ

নিচের উদাহরণটি দেখায় কিভাবে গ্র্যান্ড ইন্দোনেশিয়া ইস্ট মলে একটি ট্রিপ তৈরি করতে হয়। এই ট্রিপে দুজন যাত্রী থাকবেন, এটি এক্সক্লুসিভ এবং এর স্ট্যাটাস NEW । ট্রিপের provider_id অবশ্যই গুগল ক্লাউড প্রোজেক্ট আইডির মতো হতে হবে। উদাহরণগুলিতে একটি গুগল ক্লাউড প্রোজেক্ট দেখানো হয়েছে যার প্রোজেক্ট আইডি my-rideshare-co-gcp-project । ফ্লিট ইঞ্জিনে কল করার জন্য এই প্রোজেক্টে একটি সার্ভিস অ্যাকাউন্টও থাকতে হবে। বিস্তারিত জানার জন্য সার্ভিস অ্যাকাউন্টের ভূমিকা দেখুন।

static final String PROJECT_ID = "my-rideshare-co-gcp-project";

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// Trip initial settings.
String parent = "providers/" + PROJECT_ID;

Trip trip = Trip.newBuilder()
    .setTripType(TripType.EXCLUSIVE) // Use TripType.SHARED for carpooling.
    .setPickupPoint(                 // Grand Indonesia East Mall.
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.195139).setLongitude(106.820826)))
    .setNumberOfPassengers(2)
    // Provide the drop-off point if available.
    .setDropoffPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.1275).setLongitude(106.6537)))
    .build();

// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
    .setParent(parent)
    .setTripId("trip-8241890")  // Trip ID assigned by the provider.
    .setTrip(trip)              // The initial state is NEW.
    .build();

// Error handling.
try {
  Trip createdTrip = tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

এরপর কি?