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

रास्ते के आस-पास मौजूद चीज़ें खोजने की सुविधा, Places (नया वर्शन) के इन एपीआई में उपलब्ध है:

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

किसी रूट के आस-पास मौजूद चीज़ें खोजना

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

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

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

किसी रूट के आस-पास मौजूद चीज़ें खोजना, खोज के नतीजों को पक्षपाती बनाने के लिए, 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 से हिसाब लगाए गए रूट में कई कॉम्पोनेंट शामिल होते हैं:

रूट में ये कॉम्पोनेंट शामिल होते हैं:

• 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} $$