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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

रास्ते में पड़ने वाली जगहें खोजकर, रास्ते की खास जानकारी का हिसाब लगाना

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

उदाहरण के लिए, Routes 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} $$