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

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

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

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

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

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

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

  • सड़क पर स्नैप करना यह सेवा, दिए गए जीपीएस कोऑर्डिनेट के सेट के आधार पर, यात्रा की गई सड़कों की जानकारी देती है. किसी रास्ते पर इकट्ठा किए गए ज़्यादा से ज़्यादा 100 जीपीएस पॉइंट तय किए जा सकते हैं. इसके अलावा, सेवा से यह अनुरोध भी किया जा सकता है कि वह अतिरिक्त पॉइंट इंटरपोलेट करे. इससे ऐसा पाथ जनरेट होगा जो सड़क की ज्यामिति के हिसाब से होगा.
  • सबसे नज़दीकी सड़कें यह सेवा, किसी जीपीएस पॉइंट के लिए सबसे नज़दीकी सड़क सेगमेंट की जानकारी देती है. ज़्यादा से ज़्यादा 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 के ज़रिए उपलब्ध संसाधनों की खास जानकारी दी गई है. साथ ही, यह भी बताया गया है कि इससे कौनसा डेटा मिलता है.

डेटा संसाधन डेटा वापस लाया गया जवाब का फ़ॉर्मैट
सड़क पर स्नैप करें

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

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

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

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

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

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

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

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

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