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

रास्ते के आस-पास मौजूद चीज़ें खोजने की सुविधा, 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} $$