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

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

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

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

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