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

रास्ते के साथ-साथ खोज करने की सुविधाएं, Places (New) 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 से होते हुए) के बीच का अंतर होता है: