रास्ते की योजना बनाना

कभी-कभी, आप उस रूट की योजना बना सकते हैं जो आपका ऐप्लिकेशन उपयोगकर्ताओं को उपलब्ध कराता है. इसका इस्तेमाल करके Routes API से मिला रूट टोकन, Routes Preferred API या Route Optimization API ये कर सकता है आपको अपने पहले से तय रास्ते के लिए दो चीज़ें तय करने में मदद करता है:

• रास्ते के लिए पॉलीलाइन

• आपके रास्ते के मकसद

उदाहरण के लिए, यहां कुछ ऐसे उदाहरण दिए गए हैं जिनमें रूटिंग के मकसद बताए गए हैं:

• डिलीवरी में लगने वाले समय को कम करना: खाना डिलीवर करने वाला कोई कारोबार खाना डिलीवर करने में लगने वाले समय को कम कर सकता है.

• यात्रा में लगने वाले समय या ईंधन की खपत को कम से कम करना: लॉजिस्टिक का कारोबार कर सकता है ड्राइवर की क्षमता को सुधारना और ईंधन की खपत को कम करना चाहते हैं.

• डेस्टिनेशन तक पहुंचने में लगने वाला समय कम करना: हो सकता है कि सेवा डिस्पैच ऑपरेशन, ऑपरेटर को किसी काम के अनुरोध पर पहुंचने में लगने वाले समय को कम करना चाहे.

• लागत में कमी और बेहतर सुरक्षा: राइड शेयर करने वाला कारोबार, शायद ऐसा रास्ता खोज सकते हैं जो यात्रियों के लिए कम खर्च में हो और सुरक्षा के लिए कुछ खास जगहों पर पहुंचने से बचें की वजह.

रूट टोकन का इस्तेमाल करके रूट का प्लान बनाने के बारे में ज़्यादा जानने के लिए, अनुरोध की रूट टोकन रूट एपीआई और ट्रांज़िशन पॉलीलाइन और रूट इसमें टोकन रूट ऑप्टिमाइज़ेशन एपीआई.

रूट के मकसद के लिए रूट टोकन का इस्तेमाल क्यों करना चाहिए

Routes API, Routes Preferred API या Route Optimization API से मिले रास्ते के टोकन की मदद से, आपको दिए गए रास्ते पर ज़्यादा कंट्रोल मिलता है:

• नेविगेशन SDK टूल का इस्तेमाल कब करना है, इसके लिए पहले से ही रूट तय कर लें किया जा सकता है.

• नेविगेशन SDK टूल के इस्तेमाल के लिए सबसे सही रास्ता चुनें. अगर आपको रूट एपीआई में रूट जनरेट करते समय रूट टोकन का अनुरोध करें, जनरेट किए गए हर रूट के लिए, आपको रूट टोकन मिलता है. इसके बाद, टोकन के रूप में मौजूद होना चाहिए जिसका उपयोग आप नेविगेशन SDK टूल.

• पहले से ही कीमत का अनुमान लगा लें. इसमें ETA और दूरी. असल खर्च और समय अलग-अलग हो सकता है. हालांकि, इस अनुमान से, रास्ते के अनुमानित और असल खर्च के बीच का अंतर कम हो जाता है.

• रास्ते के ज़्यादा बेहतर लक्ष्य तय करें. जैसे, ईको-राउटिंग या सबसे छोटा रास्ता.

रूट टोकन कैसे काम करते हैं

आप Routes API, Routes Preferred API का इस्तेमाल कर सकते हैं या रूट ऑप्टिमाइज़ेशन एपीआई की मदद से, रास्ते के मकसद का इस्तेमाल करके रास्ते की योजना बनाएं. आपने लोगों तक पहुंचाया मुफ़्त में इनमें से किसी भी एपीआई से लौटाए गए रूट टोकन को नेविगेशन SDK टूल, ताकि यह आपके वाहन को रूट करने का तरीका बता सके.

रूट टोकन का अनुरोध करने और उसका इस्तेमाल करने पर क्या होता है, यहां बताया गया है:

1. रूट एपीआई, रूट पसंदीदा एपीआई या रूट ऑप्टिमाइज़ेशन एपीआई एन्क्रिप्ट (सुरक्षित) किया गया रूट टोकन दिखाता है. इसमें रूट पॉलीलाइन और रूट के मकसद शामिल हैं.

2. आपने रूट टोकन को Navigation SDK टूल को पास किया है.

3. नेविगेशन SDK टूल, रूट का पता लगाता है या रूट के तौर पर मौजूद नहीं होता बदलती स्थितियों के कारण उपलब्ध होने पर, यह सबसे अच्छे मेल खाने वाले रूट को हासिल कर लेता है.

4. रास्ता चलाते समय, अगर ट्रैफ़िक या सड़क की स्थितियों में बदलाव होता है या वाहन पहले से तय किए गए रास्ते से हट जाता है, लेकिन रूट में लगातार बदलाव किए गए हैं टोकन में दिए गए रूट के मकसद के आधार पर सबसे अच्छे रूट को मैच करने की कोशिश करेगा.

इस प्रोसेस से, यह तय किया जाता है कि आपके प्लान किए गए रास्ते के मुकाबले, असल रास्ता कितना करीब है.

किसी पहले से तय रास्ते का सटीक रूप से पालन क्यों नहीं किया जा सकता

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

रूट टोकन का इस्तेमाल करके रूट प्लान करना

आप रूट टोकन बनाकर और फिर उसे नेविगेशन SDK टूल, जैसा कि नीचे दिए गए चरणों में बताया गया है:

पहला चरण: Routes API, Routes Preferred API या Route Optimization API का इस्तेमाल करके, रूट टोकन बनाना

1. इनमें से किसी एक तरीके का इस्तेमाल करके, रास्ते का टोकन पाने का अनुरोध करें:

   • Routes API: computeRoutes. Reader Revenue Manager को सेट अप करने के बारे में रूट एपीआई में रूट टोकन का अनुरोध करने के बारे में जानने के लिए, देखें किसी रास्ते का पता लगाना और किसी रास्ते का अनुरोध करें टोकन का इस्तेमाल करें.

   • Routes Preferred API: computeCustomRoutes. ज़्यादा के लिए में कोई रूट टोकन अनुरोध करने के बारे में जानकारी रूट को प्राथमिकता देने वाला एपीआई, रूट तय करने का विकल्प है.

   • रूट ऑप्टिमाइज़ेशन एपीआई: optimizeTours या batchOptimizeTours. किसी रास्ते का अनुरोध करने के बारे में ज़्यादा जानकारी के लिए रूट ऑप्टिमाइज़ेशन एपीआई में टोकन के लिए, ट्रांज़िशन पॉलीलाइन और रूट देखें टोकन.

2. रूट टोकन का इस्तेमाल करने से जुड़ी ज़रूरी शर्तें पूरी करने के लिए, Routes API या Routes Preferred API का अनुरोध सेट अप करें:

   • travel_mode को DRIVING या TWO_WHEELER पर सेट करें
   • routing_preference को TRAFFIC_AWARE या TRAFFIC_AWARE_OPTIMAL पर सेट करें
   • Via वेपॉइंट का इस्तेमाल न करें

दूसरा चरण: नेविगेशन SDK टूल पर रूट टोकन पास करना

1. रूट टोकन सेव करें: नेविगेशन SDK टूल में, कोई स्ट्रिंग सेट अप करें रूट टोकन सेव करने के लिए. उदाहरण के लिए:

   String routeToken = "route token returned by Routes API";

   रूट टोकन के दिखाए गए का उदाहरण:

   {
   // Other fields
   "routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g",
   }
   

2. इसका इस्तेमाल करके नेविगेशन SDK को रूट टोकन पास करें Navigator.setDestinations विधि, समान गंतव्य तय करना वेपॉइंट जिनका इस्तेमाल आपने रूट टोकन बनाते समय किया था:

   setDestinations(List destinations, CustomRoutesOptions customRoutesOptions, DisplayOptions displayOptions);

   उदाहरण के लिए:

   CustomRoutesOptions customRoutesOptions =
         CustomRoutesOptions.builder()
         .setRouteToken(routeToken)
         .setTravelMode(TravelMode.DRIVING)
         .build();

Navigator.setDestinations तरीका, अनुरोध की स्थिति दिखाता है. अगर आपने यह वाहन की जगह से तय मंज़िल तक का रास्ता ढूंढता है, यह RouteStatus.OK दिखाता है.

इस तरीके के बारे में ज़्यादा जानकारी के लिए, Navigator.setDestinations देखें.

उदाहरण

उदाहरण के तौर पर दिया गया यह कोड दिखाता है कि रूट टोकन की ज़रूरत पड़ सकती है.

    ArrayList <Waypoint> destinations = Lists.newArrayList();
    Waypoint waypoint1 =
       Waypoint.builder()
          .setLatLng(10, 20)
          .setTitle("title")
          .setVehicleStopover(true)
          .build();
    destinations.add(waypoint1);
    Waypoint waypoint2 =
       Waypoint.builder()
          .setPlaceId("ChIJYV-J-ziuEmsRIMyoFaMedU4")
          .setTitle("title")
          .setVehicleStopover(true)
           .build()
    destinations.add(waypoint2);

    String routeToken = "route token returned by Routes API";

    CustomRoutesOptions customRoutesOptions =
       CustomRoutesOptions.builder()
          .setRouteToken(routeToken)
          .setTravelMode(TravelMode.DRIVING)
          .build();

    // Existing flow to get a Navigator.
    NavigationApi.getNavigator(...);

    // Existing flow for requesting routes.
    ListenableResultFuture<RouteStatus> routeStatusFuture =
        navigator.setDestinations(destinations, customRoutesOptions);

    // Or with display options.
    DisplayOptions displayOptions = new DisplayOptions();

    ListenableResultFuture<RouteStatus> routeStatusFuture =
        navigator.setDestinations(destinations, customRoutesOptions, displayOptions);

रूट टोकन और नेविगेशन SDK टूल कैसे इंटरैक्ट करते हैं

यहां बताया गया है कि नेविगेशन SDK टूल से जनरेट किया गया रास्ता और रास्ते के टोकन में तय किया गया रास्ता, कैसे इंटरैक्ट करते हैं:

• पहले से सेट किए गए किसी भी डेस्टिनेशन को बदल देता है.

• इस्तेमाल किया जाता है, जहां से वाहन शुरू होता है.

• सड़क और ट्रैफ़िक की स्थितियों के हिसाब से बदलाव हो सकता है. यहां जाएं: तय किए गए रास्ते को सही तरीके से फ़ॉलो क्यों नहीं किया जा सकता.

• रूटिंग से जुड़े इन विकल्पों को ज़रूरत न होने के तौर पर अनदेखा करता है:

  • avoidsHighways
  • avoidsTolls
  • avoidsFerries
  • licensePlateRestriction

• फ़ॉलो किया जा रहा है:

  • वेपॉइंट से जुड़े विकल्प, जैसे कि सड़क के किनारे की प्राथमिकता.

  • रास्ते के मकसद. अगर नेविगेशन SDK टूल को दिखाए गए रूट में बदलाव करना है, तो वह रूट टोकन का अनुरोध करते समय बताए गए रूट के मकसद का इस्तेमाल करता है. इस वजह से, आपको वेहिकल के रास्ते के उन विकल्पों का इस्तेमाल करना चाहिए जिन्हें आपने Routes API में बताया है.