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

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

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

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

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

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

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

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

उदाहरण के लिए, मूल स्थान से मार्ग पर विचार करें, जिसे रूट एपीआई में वेपॉइंट, रास्तों के हिसाब से मंज़िल तक पहुंचने के लिए एपीआई:

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

रूटिंग की खास जानकारी का हिसाब लगाना

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

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

नतीजों में दिखने वाली हर जगह के लिए, जवाब में यात्रा की अवधि और राउटिंग ऑरिजिन से जगह की दूरी शामिल होती है. हालांकि, यह जानकारी सिर्फ़ तब दिखती है, जब यह उपलब्ध हो.

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

डिफ़ॉल्ट रूप से, यात्रा की अवधि और दूरी का हिसाब लगाने के लिए, 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 के हिसाब से, कई कॉम्पोनेंट मिलकर एक रास्ता बनाते हैं:

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

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

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

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

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

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

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

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

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

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

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