रास्ते के आस-पास मौजूद चीज़ें खोजने की सुविधा के बारे में खास जानकारी

रास्ते में खोज करने की सुविधाएं, Places API (नया वर्शन) के इन वर्शन में उपलब्ध हैं:

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

रास्ते के आस-पास मौजूद जगहें खोजना

दो जगहों के बीच यात्रा के रास्ते का हिसाब लगाने के लिए, Routes API का इस्तेमाल किया जाता है. Routes API, कार, साइकल, दोपहिया वाहन, सार्वजनिक परिवहन या पैदल चलने के लिए रास्ते की जानकारी का हिसाब लगा सकता है.

टेक्स्ट से खोजें (नई सुविधा) की मदद से, इस कैलकुलेट किए गए रास्ते का इस्तेमाल करके रास्ते के आस-पास मौजूद चीज़ें खोजी जा सकती हैं. इस विकल्प की मदद से, Routes API से पहले से कैलकुलेट किया गया रूट, टेक्स्ट से खोजें (नया) अनुरोध को पास किया जाता है. इसके बाद, जवाब में वे जगहें शामिल होती हैं जो खोज के मानदंड से मेल खाती हैं. साथ ही, वे बताई गई जगह के आस-पास भी मौजूद होती हैं.

रास्ते के साथ-साथ खोज करने की सुविधा, खोज के नतीजों को पक्षपाती बनाने के लिए locationRestriction या locationBias अनुरोध विकल्पों का इस्तेमाल करने जैसी है. locationRestriction, खोज के ऐसे नतीजे दिखाता है जो व्यूपोर्ट की सीमाओं के अंदर आते हैं. वहीं, locationBias, खोज के ऐसे नतीजे दिखा सकता है जो व्यूपोर्ट की सीमाओं के बाहर आते हैं. हालांकि, locationBias और locationRestriction विकल्पों की मदद से, खोज के नतीजों में किसी क्षेत्र को शामिल किया जा सकता है. वहीं, टेक्स्ट से खोजें में रास्ते के आस-पास मौजूद चीज़ों को खोजने की सुविधा की मदद से, खोज के नतीजों में उन चीज़ों को शामिल किया जा सकता है जो रास्ते के शुरुआती पॉइंट से मंज़िल तक पहुंचने में कम से कम समय लेती हैं. पॉलीलाइन के साथ locationBias या locationRestriction का इस्तेमाल करके, खोज के नतीजों को पक्षपातपूर्ण बनाया जा सकता है.

उदाहरण के लिए, Routes API की मदद से, यात्रा शुरू करने की जगह से मंज़िल तक के रास्ते का हिसाब लगाया जाता है. इस रास्ते को Routes API में वेपॉइंट कहा जाता है:

रास्ते में खोज करने पर, खोज के नतीजे इस तरह से दिखाए जाते हैं कि रास्ते के आस-पास की जगहों के बारे में जानकारी मिले. साथ ही, शुरुआती जगह से मंज़िल तक पहुंचने में कम से कम समय लगे. इस उदाहरण में, A, B, और C पॉइंट, खोज के नतीजों में दिखाई गई जगहें हैं.

रास्ते की जानकारी का हिसाब लगाना

टेक्स्ट से खोजें (नया) और आस-पास की जगहों की जानकारी (नया), रास्ते की खास जानकारी का हिसाब लगा सकते हैं. इसका मतलब है कि अनुरोध में बताई गई रास्ते की शुरुआती जगह के आधार पर, जवाब में मौजूद हर जगह तक पहुंचने में लगने वाला समय और दूरी का हिसाब लगाया जा सकता है. रास्ते की शुरुआत की जगह की जानकारी देने पर, जवाब में न सिर्फ़ खोज से मेल खाने वाली जगहों की सूची शामिल होती है, बल्कि रास्ते की शुरुआत की जगह से हर जगह तक की यात्रा की अवधि और दूरी भी शामिल होती है.

नीचे दी गई इमेज में, A, B, और C पॉइंट, खोज के जवाब में दिखाए गए स्थान हैं:

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

डिफ़ॉल्ट रूप से, यात्रा की अवधि और दूरी का हिसाब लगाने के लिए, Routes API में TRAFFIC_UNAWARE विकल्प का इस्तेमाल किया जाता है. आपके पास राउटिंग की प्राथमिकताएं सेट करने का विकल्प होता है. इससे कैलकुलेशन के दौरान, लाइव ट्रैफ़िक का हाल TRAFFIC_AWARE_OPTIMAL या कम इंतज़ार के समय वाले लाइव ट्रैफ़िक का हाल TRAFFIC_AWARE को ध्यान में रखा जाता है.

रास्तों, लेग, और रास्ते में रुकने की जगहों के बारे में जानकारी

Routes API के हिसाब से, किसी रूट में कई कॉम्पोनेंट होते हैं:

किसी रूट में ये कॉम्पोनेंट होते हैं:

• Waypoint: किसी रास्ते का हिसाब लगाने के लिए, आपको कम से कम शुरुआती जगह और मंज़िल की जानकारी देनी होती है. इन जगहों को रास्ते में वेपॉइंट के तौर पर तय किया जाता है. इंटरमीडिएट वेपॉइंट, यात्रा शुरू करने की जगह और मंज़िल के बीच की वे जगहें होती हैं जहां से आपको रास्ते को गुज़ारना होता है.

• रास्ता: यात्रा शुरू करने की जगह से लेकर मंज़िल तक के पूरे रास्ते को 'रास्ता' कहा जाता है. इसमें बीच में पड़ने वाले वेपॉइंट भी शामिल होते हैं. किसी रास्ते में एक या उससे ज़्यादा लेग होते हैं.

  टेक्स्ट से खोजें को कोई रूट पास करते समय, आपको Routes API से मिले रूट की एन्कोड की गई पॉलीलाइन पास करनी होती है. कोड में बदली गई पॉलीलाइन, अक्षांश और देशांतर के पॉइंट की कोड में बदली गई सूची होती है. इससे रास्ते की पॉलीलाइन को स्ट्रिंग के तौर पर दिखाया जा सकता है.

• लेग: किसी रास्ते में एक वेपॉइंट से अगले वेपॉइंट तक का रास्ता. हर लेग में एक या उससे ज़्यादा अलग-अलग चरण होते हैं.

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

  शुरुआत और मंज़िल के बाद, रास्ते में जोड़े गए हर अतिरिक्त वेपॉइंट के लिए, एपीआई एक अलग लेग जोड़ता है. इसे इंटरमीडिएट वेपॉइंट कहा जाता है.

रास्तों और रास्तों का हिसाब लगाने के बारे में ज़्यादा जानकारी के लिए, Routes API देखें.

रास्ते के साथ खोज करने की सुविधा का इस्तेमाल करके, रास्ते की खास जानकारी का हिसाब लगाना

रास्ते की खास जानकारी के साथ रास्ते में खोजें सुविधा का इस्तेमाल किया जा सकता है. इस मामले में, टेक्स्ट खोज (नई सुविधा) सुविधा, जवाब में हर जगह की यात्रा की अवधि और दूरी की जानकारी देती है. इसके बाद, हर जगह से रूट के आखिरी डेस्टिनेशन तक की जानकारी देती है. इस कैलकुलेशन को इस तरह समझें कि अगर खोज नतीजों में किसी जगह पर जाने के लिए, तय किए गए रास्ते से हटकर कोई दूसरा रास्ता चुना जाता है और फिर उसी रास्ते से अपनी मंज़िल तक पहुंचा जाता है, तो इस कैलकुलेशन से यात्रा की अवधि और दूरी का पता चलता है.

उदाहरण के लिए, Routes API से कैलकुलेट किया गया, ऑरिजिन से डेस्टिनेशन तक का यह रूट देखें. इस रास्ते को Text Search (New) API के साथ-साथ, खोज के लिए इस्तेमाल किए जाने वाले शब्दों के साथ पास करें.

इस उदाहरण में, जगह A, टेक्स्ट से खोजें (नया) के खोज नतीजों में दिखाई गई जगह है. जवाब में शामिल हर जगह के लिए, खोज में यह जानकारी शामिल होती है: दो चरणों वाली यात्रा के तौर पर उस जगह पर जाने के लिए, यात्रा की अवधि और दूरी:

• पहले चरण में, यात्रा की अवधि और रास्ते की दूरी शामिल होती है. यह दूरी, यात्रा शुरू करने की जगह से जगह तक की होती है. इस उदाहरण में, मूल जगह से जगह A तक.
• दूसरे लेग में, जगह से लेकर रास्ते के गंतव्य तक की यात्रा की अवधि और दूरी शामिल होती है. इस उदाहरण में, A से डेस्टिनेशन तक.

जवाब में दी गई जानकारी से, डिटूर की अवधि और दूरी का हिसाब लगाया जा सकता है. इसमें:

• \(t_{OD}\) , यात्रा शुरू करने की जगह से मंज़िल तक पहुंचने में लगने वाला समय है \(s_{OD}\) , यात्रा शुरू करने की जगह से मंज़िल तक की दूरी है
• \(t_{OA}\) , ऑरिजिन से A तक की यात्रा की अवधि है; \(s_{OA}\) , ऑरिजिन से A तक की यात्रा की दूरी है
• \(t_{AD}\) , A से मंज़िल तक की यात्रा की अवधि है; \(s_{AD}\) , A से मंज़िल तक की यात्रा की दूरी है

डिटूर की अवधि, यात्रा की अवधि में अंतर होता है. यह अंतर, ओरिजनल यात्रा (यात्रा शुरू करने की जगह से मंज़िल तक) और नई यात्रा (यात्रा शुरू करने की जगह से मंज़िल तक होकर A) के बीच होता है:

डिटूर की दूरी, दूरी में अंतर होता है. यह मूल यात्रा (शुरू होने की जगह से मंज़िल तक) और नई यात्रा (शुरू होने की जगह से मंज़िल तक होकर A) के बीच का अंतर होता है: