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

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

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

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

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

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

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

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

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 Snap to roads का डेमो आज़माना ट्रैक बनाने के लिए डेमो पर क्लिक करें. साथ ही, देखें कि सड़कों पर स्नैप करने वाला एंडपॉइंट, सटीक डेटा कैसे उपलब्ध कराता है. सड़क पर स्नैप करने की सुविधा से जुड़ी गाइड में, डेमो देखें. आपको एपीआई पासकोड की ज़रूरत नहीं है.
2 सेट अप करना सबसे पहले, Google Cloud प्रोजेक्ट सेट अप करें. इसके बाद, सेटअप से जुड़े निर्देशों का पालन करें. इसके बाद, एपीआई कुंजी इस्तेमाल करने का तरीका जानें.
3 सड़क पर स्नैप करने का अनुरोध करें सड़क पर स्नैप करने की सुविधा के उदाहरणों में से किसी एक का इस्तेमाल करें और अपने इस्तेमाल के उदाहरण के हिसाब से कोई उदाहरण आज़माएं.
4 सड़क के हिसाब से गति सीमा की जानकारी पाना सड़क पर स्नैप करने के अनुरोध के लिए दिए गए पाथ डेटा का इस्तेमाल करके, स्पीड लिमिट की क्वेरी जारी करें. पाथ का इस्तेमाल करके अनुरोध करने का उदाहरण देखें.
5 लंबे पाथ को प्रोसेस करने का तरीका जानें ऐडवांस कॉन्सेप्ट गाइड में, लंबे पाथ प्रोसेस करना सेक्शन में दिया गया तरीका अपनाएं.
6 अपने ऐप्लिकेशन में सड़क का डेटा शामिल करें! अपने ऐप्लिकेशन में सड़क के डेटा से जुड़ी सुविधा बनाने के लिए, सड़क के स्नैप किए गए डेमो का कोड का उदाहरण देखें.

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

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

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

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