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

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

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

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

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

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

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