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

ऊंचाई से एपीआई, ऐसी सेवा है जो पृथ्वी पर किसी जगह की जानकारी के लिए, ऊंचाई से जुड़ा डेटा दिखाती है.

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

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

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

Elevation API की मदद से, अपने ऐप्लिकेशन में या मैप पर, ऊंचाई का डेटा शामिल किया जा सकता है. उदाहरण के लिए:

  • किसी खास जगह की ऊंचाई पाएं.
  • किसी रास्ते पर या दो बिंदुओं के बीच, ऊंचाई में अंतर कैलकुलेट करें.

Elevation API कैसे काम करता है

ऊंचाई API, अक्षांश/देशांतर निर्देशांकों के साथ एन्कोड किए गए यूआरएल के रूप में अनुरोध को स्वीकार करता है, जो अलग-अलग जगहों के रूप में या पाथ के साथ स्थानों की शृंखला के रूप में दिया जाता है. उदाहरण के लिए, इस अनुरोध में, डेनवर, कोलोराडो के बीच वाले हिस्से की क्वेरी के हिसाब से, JSON फ़ॉर्मैट में रिटर्न दिखाया जाता है. 
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

यह सेवा दी गई निर्देशांकों के लिए ऊंचाई का पता लगाती है. यह बिना ऊंचाई वाले किसी स्थान की ऊंचाई का अनुमान भी लगाता है. इससे, ऊंचाई का डेटा उपलब्ध कराने वाली चार नज़दीकी जगहों से औसत उत्सर्जन पता चलता है. अंत में, यह स्थान के लिए संपूर्ण रिज़ॉल्यूशन निर्धारित करता है.

रिसॉर्स

इस टेबल में, ऊंचाई से मिलने वाले एपीआई और उपलब्ध डेटा की खास जानकारी दी गई है.

डेटा संसाधन डेटा दिखाया गया सामान लौटाने का फ़ॉर्मैट
अक्षांश/देशांतर निर्देशांक

एक या ज़्यादा जगहों के सेट या पाथ के साथ सीरीज़ के तौर पर डेटा दिया जा सकता है. कोड में बदले गए निर्देशांक भी दिए जा सकते हैं. ज़्यादा से ज़्यादा 512 निर्देशांक पास करें.

ऊंचाई एपीआई स्थानीय औसत समुद्र स्तर (LMSL) के मुकाबले मीटर में ऊंचाई देता है. यहां बताए गए तरीके के मुताबिक, ऊंचाई को पॉज़िटिव या नेगेटिव वैल्यू के तौर पर दिखाया जा सकता है:

  • पॉज़िटिव वैल्यू, LMSL के ऊपर मौजूद जगहों की जानकारी देती है. इनमें, सतह के ऊपर मौजूद जगहें या ऊंचाई पर मौजूद झीलें शामिल हैं.
  • नेगेटिव वैल्यू, LMSएल के नीचे की जगहों को दिखाती हैं. इनमें, सतह या महासागर के तल पर मौजूद जगहें शामिल हैं.
  • रिज़ॉल्यूशन, डेटा पॉइंट और ऊंचाई के बीच की दूरी मीटर में बताता है.
  • JSON
  • एक्सएमएल

ऊंचाई एपीआई इस्तेमाल करने का तरीका

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

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

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

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

आगे क्या