एक मंज़िल की यात्रा बनाएं

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

• Fleet Engine सेट अप करना
• वाहन बनाना

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

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

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

ध्यान दें: CreateTrip() का इस्तेमाल करने के लिए, उस खास खाते के क्रेडेंशियल की ज़रूरत होती है जिसके बारे में Fleet Engine: सेवा खाता भूमिकाओं में बताया गया है.

यात्रा के फ़ील्ड

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

यात्रा के फ़ील्ड

नाम	ज़रूरी है?	ब्यौरा
parent	हां	ऐसी स्ट्रिंग जिसमें प्रोजेक्ट आईडी शामिल होता है. यह आईडी वही होना चाहिए जिसका इस्तेमाल आपके फ़्लीट इंजन के पूरे इंटिग्रेशन में किया गया हो और सेवा खाते की भूमिकाएं एक जैसी हों.
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	नहीं	यात्रा के लिए असाइन किए गए वाहन का आईडी.

उदाहरण: एक ही डेस्टिनेशन की यात्रा

नीचे दिए गए उदाहरण में, ग्रैंड इंडोनेशिया ईस्ट मॉल के लिए ट्रिप प्लान करने का तरीका बताया गया है. इस यात्रा में दो यात्री शामिल हैं. यह यात्रा खास है और इसका स्टेटस NEW है. यात्रा का provider_id, Google Cloud प्रोजेक्ट आईडी से मेल खाना चाहिए. इन उदाहरणों में, प्रोजेक्ट आईडी my-rideshare-co-gcp-project वाला Google Cloud प्रोजेक्ट दिखाया गया है. Fleet Engine को कॉल करने के लिए, इस प्रोजेक्ट में एक सेवा खाता भी होना चाहिए. ज़्यादा जानकारी के लिए, सेवा खाते की भूमिकाएं देखें.

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

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

• यात्रा की स्थिति अपडेट करना और उसे मैनेज करना
• ड्राइवर SDK टूल सेट अप करना