एक के बाद एक ट्रिप बनाएं

इस दस्तावेज़ में, बैक-टू-बैक ट्रिप बनाने, सही फ़ील्ड सेट करने, और उसे पूरा करने के लिए किसी वाहन को असाइन करने का तरीका बताया गया है. यह मानकर चलता है कि आपने Fleet Engine सेट अप कर लिया है, वाहन बना लिए हैं, और ड्राइवर ऐप्लिकेशन काम कर रहा है. इसके अलावा, आपके पास उपभोक्ता ऐप्लिकेशन भी हो सकता है. आपको मांग पर उपलब्ध यात्राओं के लिए, यात्रा के अलग-अलग मामलों के बारे में भी पता होना चाहिए. इसके लिए, यहां दी गई गाइड देखें:

यात्रा की जानकारी जोड़ने से जुड़ी बुनियादी बातें

इस सेक्शन में, Fleet Engine में यात्रा बनाने के लिए ज़रूरी अनुरोध की जानकारी दी गई है. gRPC और REST, दोनों में से किसी एक का इस्तेमाल करके, खाता बनाने का अनुरोध किया जा सकता है.

  • CreateTrip() तरीका: gRPC या REST
  • CreateTripRequest मैसेज: सिर्फ़ gRPC के लिए

यात्रा से जुड़े फ़ील्ड

Fleet Engine में यात्रा बनाने के लिए, इन फ़ील्ड का इस्तेमाल करें. अलग-अलग तरह की यात्राओं के लिए, अलग-अलग फ़ील्ड का इस्तेमाल किया जा सकता है. जैसे, एक या एक से ज़्यादा मंज़िलों वाली यात्राएं, बैक-टू-बैक यात्राएं या शेयर की गई पूल यात्राएं. यात्रा बनाते समय, वैकल्पिक फ़ील्ड की जानकारी दी जा सकती है. इसके अलावा, यात्रा को अपडेट करते समय भी उन्हें सेट किया जा सकता है.

यात्रा से जुड़े फ़ील्ड
नाम ज़रूरी है? ब्यौरा
parent हां एक स्ट्रिंग, जिसमें प्रोजेक्ट आईडी शामिल होता है. यह आईडी, आपके पूरे Fleet Engine इंटिग्रेशन में इस्तेमाल किए गए आईडी से मेल खाना चाहिए. साथ ही, इसमें सेवा खाते की भूमिकाएं भी एक जैसी होनी चाहिए.
trip_id हां एक स्ट्रिंग, जिसे आपने इस यात्रा की खास तौर पर पहचान करने के लिए बनाया है. यात्रा के आईडी पर कुछ पाबंदियां होती हैं. इनके बारे में रेफ़रंस में बताया गया है.
trip_type हां जिस तरह की यात्रा के लिए विज्ञापन बनाया जा रहा है उसके लिए, TripType को इन वैल्यू पर सेट करें:
  • एक डेस्टिनेशन: इसे SHARED या EXCLUSIVE पर सेट करें.
  • एक से ज़्यादा डेस्टिनेशन: इसे EXCLUSIVE पर सेट करें.
  • एक के बाद एक: EXCLUSIVE पर सेट करें.
  • शेयर किया गया पूल: SHARED पर सेट है.
pickup_point हां यात्रा शुरू होने की जगह.
इंटरमीडिएट डेस्टिनेशन हां

सिर्फ़ एक से ज़्यादा जगहों की यात्राओं के लिए: उन जगहों की सूची जहां ड्राइवर, पिकअप और ड्रॉप-ऑफ़ के बीच में रुकता है. dropoff_point की तरह ही, इस फ़ील्ड को भी बाद में UpdateTrip को कॉल करके सेट किया जा सकता है. हालांकि, एक से ज़्यादा जगहों की यात्रा में, बीच में रुकने की जगहें शामिल होती हैं.
vehicle_waypoints हां

सिर्फ़ शेयर की गई यात्राएं: इस फ़ील्ड में, कई यात्राओं के वेपॉइंट को इंटरलीव किया जा सकता है. इसमें असाइन किए गए वाहन के लिए, बाकी बचे सभी वेपॉइंट शामिल होते हैं. साथ ही, इस यात्रा के लिए पिकअप और ड्रॉप-ऑफ़ वेपॉइंट भी शामिल होते हैं. CreateTrip या UpdateTrip को कॉल करके, इस फ़ील्ड को सेट किया जा सकता है. UpdateVehicle को कॉल करके, waypoints फ़ील्ड की मदद से वाहन के वेपॉइंट भी अपडेट किए जा सकते हैं. निजता की वजहों से, यह सेवा GetTrip कॉल के लिए यह जानकारी नहीं दिखाती.
number_of_passengers नहीं यात्रा में शामिल यात्रियों की संख्या.
dropoff_point नहीं यात्रा का डेस्टिनेशन.
vehicle_id नहीं यात्रा के लिए असाइन किए गए वाहन का आईडी.

उदाहरण: एक के बाद एक यात्रा की सुविधा चालू करना

यहां बैक-टू-बैक ट्रिप बनाने और उसे किसी वाहन को असाइन करने का तरीका बताया गया है. इस मामले में, यात्रा तैयार करने की प्रोसेस वैसी ही होती है जैसी एक डेस्टिनेशन वाली यात्रा के लिए होती है. इसके बाद ही, कोई दूसरी यात्रा बनाई जा सकती है और उसे किसी ऐसे वाहन को असाइन किया जा सकता है जो पहले से ही किसी यात्रा पर है.

// 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;
}

एक के बाद एक की जाने वाली यात्राओं की जानकारी अपडेट करना

बैक-टू-बैक ट्रिप के लिए वाहन असाइन करने का मतलब है कि किसी वाहन को पहले से ही कोई ट्रिप असाइन होने के बावजूद, उसे एक और ट्रिप असाइन करना.

Fleet Engine में बनाई गई किसी भी यात्रा को किसी वाहन को असाइन करना ज़रूरी है, ताकि Fleet Engine यात्रा के ईटीए का हिसाब लगा सके और उसे ट्रैक कर सके. ऐसा यात्रा तैयार करते समय या बाद में यात्रा को अपडेट करते समय किया जा सकता है.

किसी वाहन को यात्रा असाइन करने के बाद, Fleet Engine वाहन के वेपॉइंट फ़ील्ड में, एक के बाद एक होने वाली यात्राओं से जुड़े वेपॉइंट अपने-आप जोड़ देता है. किसी यात्रा के remainingWaypoints फ़ील्ड में, सभी वेपॉइंट की सूची होती है. इसमें अन्य यात्राओं के वेपॉइंट भी शामिल होते हैं. इन वेपॉइंट पर, यात्रा के ड्रॉप-ऑफ़ से पहले विज़िट किया जाएगा.

उदाहरण के लिए, मान लें कि आपने एक के बाद एक दो यात्राएं कीं: यात्रा A और यात्रा B. वाहन ने यात्रा A के लिए उपभोक्ता को पिकअप कर लिया है. ड्रॉप-ऑफ़ की जगह पर जाते समय, ड्राइवर को अगली यात्रा, यात्रा B के लिए किसी अन्य उपभोक्ता को पिकअप करने का अनुरोध मिलता है.

  • getVehicle() को कॉल करने पर, remainingWaypoints मिलता है. इसमें ये शामिल हैं:
    A ड्रॉप-ऑफ़ → B पिकअप → B ड्रॉप-ऑफ़.
  • getTrip() या onTripRemainingWaypointsUpdated कॉलबैक, यात्रा A के लिए remainingWaypoints दिखाता है. इसमें यह जानकारी शामिल होती है:
    ड्रॉप-ऑफ़.
  • getTrip() या यात्रा B के लिए onTripRemainingWaypointsUpdated कॉलबैक, remainingWaypoints दिखाता है. इसमें ये शामिल हैं:
    A ड्रॉप-ऑफ़ → B पिकअप → और B ड्रॉप-ऑफ़.

आगे क्या करना है