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

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

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

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

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

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

रास्ते के साथ-साथ खोज करने की सुविधा, खोज के नतीजों को बेहतर बनाने के लिए 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: किसी रास्ते का हिसाब लगाने के लिए, आपको कम से कम शुरुआती जगह और मंज़िल की जानकारी देनी होती है. इन जगहों को रास्ते में वेपॉइंट के तौर पर तय किया जाता है. इंटरमीडिएट वेपॉइंट, यात्रा शुरू करने की जगह और मंज़िल के बीच की वे जगहें होती हैं जहां से आपको रास्ते को गुज़ारना होता है.

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

  Text Search API को कोई रास्ता पास करते समय, आपको 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) के बीच का अंतर होता है: