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

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

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

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

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

ध्यान दें: Places API, ट्रांज़िट सिस्टम के रास्तों के साथ काम नहीं करता है.

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

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

उदाहरण के लिए, Routes API की मदद से यात्रा शुरू करने की जगह से मंज़िल तक के रास्ते का हिसाब लगाया जाता है. इस रास्ते में मौजूद हर जगह को Routes 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 के हिसाब से, किसी रास्ते में कई कॉम्पोनेंट होते हैं:

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

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

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

  टेक्स्ट सर्च को कोई रास्ता पास करते समय, 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} $$