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

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

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

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

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

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

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

उदाहरण के लिए, Routes API से कैलकुलेट किए गए रास्ते को देखें. यह रास्ता, यात्रा शुरू करने की जगह से मंज़िल तक का है. Routes API में, यात्रा शुरू करने की जगह को वेपॉइंट कहा जाता है:

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

रास्ते की खास जानकारी का हिसाब लगाना

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

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

नतीजों में मौजूद हर जगह के लिए, जवाब में यात्रा में लगने वाला समय और शुरुआती जगह से उस जगह की दूरी की जानकारी शामिल होती है. हालांकि, ऐसा तब होता है, जब यह जानकारी उपलब्ध हो.

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

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

Routes API से कैलकुलेट किए गए रूट में कई कॉम्पोनेंट होते हैं:

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

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

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

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

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

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

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

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

रास्ते के आस-पास मौजूद जगहों को खोजने की सुविधा का इस्तेमाल करके, रास्ते की खास जानकारी का हिसाब लगाना

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

उदाहरण के लिए, Routes API से कैलकुलेट किए गए, शुरुआत की जगह से मंज़िल तक के इस रास्ते को देखें. इस रास्ते को Text Search (New) API को पास करें. साथ ही, खोज के लिए इस्तेमाल होने वाले शब्द भी पास करें.

इस उदाहरण में, जगह A वह जगह है जो टेक्स्ट से खोजें (नया वर्शन) सुविधा की मदद से खोज के नतीजों में मिली है. जवाब में मौजूद हर जगह के लिए, खोज में उस जगह तक जाने के लिए ज़रूरी समय और दूरी की जानकारी शामिल होती है. इसे दो चरणों वाली यात्रा के तौर पर दिखाया जाता है:

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

रिस्पॉन्स में दी गई जानकारी से, चक्करदार रास्ते की अवधि और दूरी का हिसाब लगाया जा सकता है. इसमें:

• \(t_{OD}\) , यात्रा शुरू करने की जगह से मंज़िल तक पहुंचने में लगने वाला समय है, \(s_{OD}\) , यात्रा शुरू करने की जगह से मंज़िल तक की दूरी है
• \(t_{OA}\) , यात्रा शुरू होने की जगह से A तक की यात्रा में लगने वाला समय है; \(s_{OA}\) , यात्रा शुरू होने की जगह से A तक की यात्रा की दूरी है
• \(t_{AD}\) , A से मंज़िल तक की यात्रा में लगने वाला समय है; \(s_{AD}\) , A से मंज़िल तक की यात्रा की दूरी है

रास्ता बदलने में लगने वाला समय, मूल यात्रा (यात्रा शुरू करने की जगह से मंज़िल तक) और नई यात्रा (यात्रा शुरू करने की जगह से मंज़िल तक, A से होकर) के बीच समय का अंतर होता है:

रास्ता बदलने पर तय की गई दूरी, मूल यात्रा (शुरुआती जगह से मंज़िल तक) और नई यात्रा (शुरुआती जगह से मंज़िल तक, A से होकर) के बीच की दूरी का अंतर होती है: