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

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

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

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

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

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

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

उदाहरण के लिए, Routes API में waypoint के तौर पर बताए गए ऑरिजिन से डेस्टिनेशन तक के रास्ते की जानकारी, Routes API के हिसाब से कैलकुलेट की गई है:

खोज के नतीजों के साथ, ऑरिजिन वेपॉइंट से डेस्टिनेशन तक का रास्ता.

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

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

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

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

पॉइंट A, B, और C, खोज के नतीजे में दिखने वाली जगहें हैं.

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

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

रास्तों, लेग, और वेपॉइंट के बारे में जानकारी

Routes API के हिसाब से, कई कॉम्पोनेंट मिलकर एक रास्ता बनाते हैं:

वे कॉम्पोनेंट जिनसे कोई रूट बनता है.

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

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

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

    टेक्स्ट सर्च में कोई रास्ता पास करते समय, 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} $$
आगे बढ़ें
रास्ते के आस-पास खोजें