रोड एपीआई की खास जानकारी

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

रोड एपीआई का इस्तेमाल क्यों करें

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

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

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

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

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

रोड एपीआई का काम करने का तरीका

रोड एपीआई ऐसे तीन एंडपॉइंट का इस्तेमाल करता है जो अक्षांश/देशांतर या जगह के आईडी या निर्देशांकों को स्वीकार करके, सड़क के रास्ते, सेगमेंट या स्पीड लिमिट का डेटा देते हैं. नीचे दिया गया उदाहरण अक्षांश/देशांतर निर्देशांकों के एक सेट के आधार पर सबसे नज़दीकी सड़क के लिए अनुरोध दिखाता है:

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

रिसॉर्स

नीचे दी गई टेबल में, Street View API के ज़रिए मिलने वाले डेटा की खास जानकारी दी गई है.

डेटा संसाधन डेटा लौटाया गया रिटर्न फ़ॉर्मैट
सड़कों पर स्नैप करना

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

  • JSON
सबसे नज़दीकी सड़कें

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

स्पीड की सीमाएं

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

रोड एपीआई का इस्तेमाल कैसे करें

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

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

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

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

आगे क्या