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

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