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

रास्ते के आस-पास मौजूद चीज़ें खोजने की सुविधा, 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, खोज के नतीजों में दिखने वाली जगहें हैं:

A, B, और C पॉइंट, खोज के जवाब में दिखाई गई जगहें हैं.

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

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

.

रूट, लेग, और वेपॉइंट के बारे में जानकारी

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

रूट बनाने वाले कॉम्पोनेंट.

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

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

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

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

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

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

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

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

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

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

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

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

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

  • पहले लेग में, रूट की शुरुआत से लेकर जगह तक पहुंचने में लगने वाले समय और दूरी की जानकारी शामिल होती है. इस उदाहरण में, यात्रा शुरू करने की जगह से जगह 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} $$