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

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

पॉइंट 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, Text Search (नया) से मिले खोज नतीजों में दिखाई गई जगह है. जवाब में शामिल हर जगह के लिए, खोज में यह जानकारी शामिल होती है: दो चरणों वाली यात्रा के तौर पर उस जगह पर जाने के लिए, यात्रा की अवधि और दूरी:

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

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

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

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

$$ t_{detour} = t_{OA} + t_{AD} - t_{OD} $$

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

$$ s_{detour} = s_{OA} + s_{AD} - s_{OD} $$
आगे बढ़ें
रास्ते के आस-पास खोजें