Roads API की खास जानकारी

Roads API ऐसी सेवा है जो मैप पर एक या एक से ज़्यादा पॉइंट के लिए अक्षांश/देशांतर निर्देशांक के साथ एचटीटीपीएस अनुरोध स्वीकार करती है. यह इन पॉइंट का इस्तेमाल, आस-पास की सड़क के सेगमेंट खोजने के लिए करता है. साथ ही, सबसे नज़दीकी सड़क के सेगमेंट और रफ़्तार की सीमाओं जैसे मेटाडेटा के साथ, एक प्लेस आईडी दिखाता है.

Roads API का इस्तेमाल क्यों करना चाहिए

Roads API की मदद से, आपको रफ़्तार की सीमाएं, पहुंचने का अनुमानित समय या सड़क से जुड़ा अन्य मेटाडेटा मिल सकता है. सड़क के इस मेटाडेटा की मदद से, ड्राइविंग के लिए बने ऐप्लिकेशन को बेहतर बनाने के लिए, यहां बताई गई सुविधाएं इस्तेमाल की जा सकती हैं:

  • अक्षांश/देशांतर निर्देशांक को किसी सड़क या सड़कों से जोड़ें.
  • निर्देशांकों के समुच्चय के लिए सबसे नजदीकी सड़क ढूंढना
  • सड़क के सेगमेंट के लिए रफ़्तार की सीमाएं देखें

Roads API की मदद से क्या-क्या किया जा सकता है

Roads API की मदद से, जीपीएस कोऑर्डिनेट को सड़क की ज्यामिति के साथ मैप किया जा सकता है. साथ ही, सड़क के सेगमेंट पर रफ़्तार की सीमा तय की जा सकती है.

  • सड़कों पर स्नैप करें यह सेवा जीपीएस कोऑर्डिनेट के दिए गए सेट के आधार पर, उन सड़कों की जानकारी देती है जिनकी यात्रा करने की संभावना सबसे ज़्यादा होती है. किसी रूट पर इकट्ठा किए गए, ज़्यादा से ज़्यादा 100 जीपीएस पॉइंट तय किए जा सकते हैं. इसके अलावा, आपके पास यह अनुरोध करने का भी विकल्प है कि सर्विस, अतिरिक्त पॉइंट के बारे में इंटरपोलेट करती हो. इससे, ऐसा पाथ बनता है जो सड़क की ज्यामिति का आसानी से पालन करता है.
  • नज़दीकी सड़कें यह सेवा, जीपीएस पॉइंट के लिए सबसे नज़दीकी सड़क सेगमेंट की जानकारी देती है. ज़्यादा से ज़्यादा 100 जीपीएस पॉइंट तय किए जा सकते हैं. यह ज़रूरी नहीं है कि आपने जो पॉइंट तय किए हैं वे किसी लगातार पाथ का हिस्सा हों.
  • रफ़्तार की सीमाएं यह सेवा, सड़क के सेगमेंट के लिए तय की गई रफ़्तार की सीमा की जानकारी देती है. स्पीड लिमिट सेवा उन सभी ग्राहकों के लिए उपलब्ध है जिनके पास ऐसेट ट्रैकिंग का लाइसेंस है. Google Maps Platform Premium प्लान के ऐसे ग्राहकों के लिए यह सुविधा चालू रहती है जिन्होंने इस्तेमाल के हिसाब से पैसे चुकाने की सुविधा का इस्तेमाल किया.

Roads API के काम करने का तरीका

Roads API में तीन एंडपॉइंट का इस्तेमाल किया जाता है, जो सड़क के रास्तों, सेगमेंट या रफ़्तार की सीमा का डेटा देने के लिए, अक्षांश/देशांतर निर्देशांक या जगह के आईडी स्वीकार करते हैं. नीचे दिए गए उदाहरण में अक्षांश/देशांतर निर्देशांक के सेट के आधार पर सबसे नज़दीकी सड़कों का अनुरोध दिखाया गया है:

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

संसाधन

नीचे दी गई टेबल में, Roads API के ज़रिए उपलब्ध संसाधनों के साथ-साथ, इससे मिलने वाला डेटा भी दिया गया है.

डेटा रिसॉर्स डेटा वापस किया गया रिटर्न फ़ॉर्मैट
सड़कों पर स्नैप करें

किसी रूट से ज़्यादा से ज़्यादा 100 जीपीएस पॉइंट का कलेक्शन दिखाता है. इसमें जगह के आईडी के साथ-साथ, सड़क के नज़ारे वाले देशांतर/अक्षांश निर्देशांक भी शामिल हैं. सड़कों पर स्नैप करें गाइड में जवाब में ज़्यादा जानकारी देखें.
  • JSON
नज़दीकी सड़कें

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

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

Roads API को इस्तेमाल करने का तरीका

1 सड़कों की जानकारी देने वाला डेमो आज़माएं डेमो पर क्लिक करके ट्रैक बनाएं और देखें कि सड़क के अंत में स्नैप करने से, बेहतर डेटा कैसे मिलता है. सड़कों के बीच में स्नैप करें गाइड में डेमो देखें. आपको एपीआई पासकोड की ज़रूरत नहीं है.
2 सेट अप करें अपना Google Cloud प्रोजेक्ट सेट अप करें और दिए गए निर्देशों का पालन करें. इसके बाद, एपीआई पासकोड को इस्तेमाल करने का तरीका जानें.
3 सड़कों की जानकारी देने के अनुरोध को स्नैप करने की सुविधा आज़माएं स्नैप टू रोड के उदाहरणों में से किसी एक का इस्तेमाल करें और आपके इस्तेमाल के उदाहरण के हिसाब से सही तरीका आज़माएं.
4 अपनी सड़क के रास्ते के लिए रफ़्तार की सीमाएं देखें आपने 'सड़कों पर स्नैप करें' सुविधा का अनुरोध करने के लिए, जिस पाथ का डेटा दिया था उसी का इस्तेमाल करके, रफ़्तार की सीमा से जुड़ी क्वेरी जारी करें. पाथ का इस्तेमाल करने के अनुरोध का उदाहरण देखें.
5 लंबे पाथ को प्रोसेस करने का तरीका जानें बेहतर कॉन्सेप्ट गाइड में लंबे पाथ को प्रोसेस करना सेक्शन में दिए गए सेक्शन देखें.
6 अपने ऐप्लिकेशन में सड़क की जानकारी शामिल करें! अपने ऐप्लिकेशन में, सड़क की जानकारी देने वाले डेमो से ज़्यादा जानकारी वाले कोड का उदाहरण देखें. इससे आपको सड़क का डेटा दिखाने की सुविधा मिलेगी.

उपलब्ध क्लाइंट लाइब्रेरी

इस एपीआई को अपनी पसंद की भाषा में कॉल करें. इसके लिए, इनमें से किसी एक क्लाइंट लाइब्रेरी का इस्तेमाल करें:

Google Maps के लिए Java क्लाइंट, Python क्लाइंट, Go क्लाइंट, और Node.js क्लाइंट, समुदाय के साथ काम करने वाली क्लाइंट लाइब्रेरी हैं. ये Apache 2.0 लाइसेंस के तहत ओपन सोर्स के तौर पर उपलब्ध होती हैं. उन्हें GitHub से डाउनलोड करें. यहां आपको इंस्टॉल करने के निर्देश और सैंपल कोड भी मिल सकता है.

आगे क्या करना है