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 अपने ऐप्लिकेशन में सड़क का डेटा शामिल करें! अपने ऐप्लिकेशन में सड़क के डेटा की सुविधा बनाने के लिए, सड़क की फ़ोटो लेने वाले डेमो में, ज़्यादा जानकारी वाला कोड का उदाहरण देखें.

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

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

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

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