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

रास्ते के साथ-साथ खोजने की सुविधाएं, 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 वे जगहें हैं जो खोज के जवाब में दिखती हैं:

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

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

बाईपास की दूरी, ओरिजनल ट्रिप (ऑरिजिन से डेस्टिनेशन तक) और नई ट्रिप (ऑरिजिन से डेस्टिनेशन तक A के ज़रिए) के बीच की दूरी का अंतर होती है: