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

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

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

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

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

नोट: ट्रांज़िट सिस्टम रूट, Places API द्वारा समर्थित नहीं हैं.

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

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

उदाहरण के लिए, रूट API में वेपॉइंट कहे जाने वाले मूल स्थान से गंतव्य तक के रूट पर विचार करें, जैसा कि रूट API द्वारा गणना की जाती है:

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

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

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

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

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

ध्यान दें: यह सिर्फ़ राउटिंग की जानकारी का अनुमान है. रास्ते की सटीक जानकारी पाने के लिए, Routes API का इस्तेमाल करें. इसमें आपको सिलसिलेवार तरीके से दिशा-निर्देश भी मिलेंगे.

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

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

रास्ते चुनने की प्राथमिकता सेट करने पर, ट्रैफ़िक की स्थितियों को ध्यान में रखकर रास्तों का हिसाब लगाया जाता है.TRAFFIC_AWARE इस वजह से, रास्ते और रास्ते की जानकारी से जुड़ी रीयल-टाइम स्थितियां ज़्यादा सटीक तरीके से दिखती हैं. डेटा क्वालिटी में यह सुधार, रिस्पॉन्स में लगने वाले समय को बढ़ाकर किया जाता है. इसलिए, परफ़ॉर्मेंस को ऑप्टिमाइज़ करने के लिए, रिस्पॉन्स में लगने वाले समय को कम किया जाता है. TRAFFIC_AWARE_OPTIMAL राउटर की प्राथमिकता सेट करने पर, ट्रैफ़िक की स्थितियों को ध्यान में रखकर रास्तों का हिसाब लगाया जाता है. हालांकि, परफ़ॉर्मेंस को बेहतर बनाने के लिए कोई ऑप्टिमाइज़ेशन लागू नहीं किया जाता. इस मोड में, सर्वर सड़क नेटवर्क की ज़्यादा बारीकी से जांच करता है, ताकि सबसे अच्छा रास्ता मिल सके.

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

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

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

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

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

  Text Search API को कोई रास्ता पास करते समय, आपको 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 से होकर) के बीच होता है:

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

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

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$