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

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

एलिवेशन एपीआई का इस्तेमाल क्यों करना चाहिए

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

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

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

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

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

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

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

संसाधन

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

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

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

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

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

Elevation API को इस्तेमाल करने का तरीका

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

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

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

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

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