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

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

Roads API का इस्तेमाल क्यों करें

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

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

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

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

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

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 से मिलने वाले संसाधनों की खास जानकारी दी गई है. साथ ही, इससे मिलने वाले डेटा की जानकारी भी दी गई है.

डेटा रिसॉर्स डेटा मिला रिटर्न फ़ॉर्मैट
Snap to roads

किसी रास्ते के लिए, ज़्यादा से ज़्यादा 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 से डाउनलोड करें. यहां आपको इन्हें इंस्टॉल करने के निर्देश और सैंपल कोड भी मिलेंगे.

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