Earth Engine ऐप्लिकेशन

परिचय

Earth Engine ऐप्लिकेशन, Earth Engine के विश्लेषण के लिए डाइनैमिक और शेयर किए जा सकने वाले यूज़र इंटरफ़ेस हैं. Apps की मदद से, विशेषज्ञ Earth Engine के डेटा कैटलॉग और विश्लेषण की क्षमता का फ़ायदा पाने के लिए, आसान यूज़र इंटरफ़ेस (यूआई) एलिमेंट का इस्तेमाल कर सकते हैं. इससे विशेषज्ञ और आम लोग, दोनों ही इसका इस्तेमाल कर सकते हैं.

Earth Engine से पब्लिश किए गए ऐप्लिकेशन, पब्लिश करते समय जनरेट किए गए ऐप्लिकेशन के यूआरएल से ऐक्सेस किए जा सकते हैं. पब्लिश किए गए किसी ऐप्लिकेशन को देखने या उससे इंटरैक्ट करने के लिए, Earth Engine खाते की ज़रूरत नहीं होती. ऐप्लिकेशन बनाने वाले व्यक्ति ने जिन ऐप्लिकेशन को 'चुनिंदा' के तौर पर चुना है वे उपयोगकर्ता के हिसाब से बनाई गई ऐप्लिकेशन की गैलरी में भी उपलब्ध होते हैं. उदाहरण के लिए, USERNAME.users.earthengine.app.

अपना ऐप्लिकेशन बनाना

Earth Engine ऐप्लिकेशन, कोड एडिटर में इस्तेमाल किए जाने वाले ज़्यादातर फ़ंक्शन का फ़ायदा ले सकते हैं. हालांकि, इसके कुछ अपवाद भी हैं. इसके अलावा, हमने ऐप्लिकेशन डेवलपर को ध्यान में रखकर, यूज़र इंटरफ़ेस एपीआई को डिज़ाइन किया है. अगर आपने यूज़र इंटरफ़ेस एपीआई का इस्तेमाल पहले कभी नहीं किया है, तो यूज़र इंटरफ़ेस एपीआई की खास जानकारी देखें.

ऐप्लिकेशन को पब्लिश करना

कोड एडिटर से कोई ऐप्लिकेशन पब्लिश करने के लिए, पहले उस स्क्रिप्ट को लोड करें जिसे आपको ऐप्लिकेशन में बदलना है. इसके बाद, ऐप्लिकेशन मैनेजमेंट पैनल खोलें. इसे ऐक्सेस करने के लिए, कोड एडिटर में स्क्रिप्ट सेक्शन के ऊपर मौजूद ऐप्लिकेशन बटन पर क्लिक करें.

ऐप्लिकेशन मैनेज करने का बटन
ऐप्लिकेशन मैनेज करने का बटन

इसके बाद, नया ऐप्लिकेशन बटन पर क्लिक करें.

नया ऐप बटन
नया ऐप बटन

डायलॉग बॉक्स में, बदलाव करने का ऐक्सेस और ऐप्लिकेशन का नाम चुनें. इसके बाद, Google Cloud प्रोजेक्ट चुनें और ऐप्लिकेशन के सोर्स कोड की जगह की जानकारी दें. इस ऐप्लिकेशन का ऐक्सेस किसी खास Google ग्रुप तक सीमित करें या 'पाबंदी' टैब में मौजूद विकल्पों का इस्तेमाल करके, इसे सार्वजनिक तौर पर ऐक्सेस करने की सुविधा चालू रखें. सार्वजनिक तौर पर ऐक्सेस किए जा सकने वाले ऐप्लिकेशन के लिए, अपनी पसंद के मुताबिक झलक दिखाने वाली इमेज भी उपलब्ध कराई जा सकती है. साथ ही, गैलरी टैब में ब्यौरा भी दिया जा सकता है. अगर आपको इस ऐप्लिकेशन को USERNAME.users.earthengine.app पर उपलब्ध ऐप्लिकेशन की सार्वजनिक गैलरी में दिखाना है, तो "इस ऐप्लिकेशन को अपनी ऐप्लिकेशन गैलरी में दिखाएं" पर क्लिक करें. अगर आप चाहें, तो ऐप्लिकेशन के सबसे ऊपर बाएं कोने में कस्टम लोगो शामिल करें. इसके लिए, लोगो टैब से अपनी पसंद की इमेज अपलोड करें.

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

अपने ऐप्लिकेशन मैनेज करना

कोड एडिटर से किसी ऐप्लिकेशन को मैनेज करने के लिए, ऐप्लिकेशन मैनेजमेंट पैनल खोलें. इसके लिए, कोड एडिटर में स्क्रिप्ट सेक्शन के ऊपर मौजूद, ऐप्लिकेशन बटन पर क्लिक करें. यहां से, अपने ऐप्लिकेशन के कॉन्फ़िगरेशन को अपडेट किया जा सकता है या ऐप्लिकेशन को मिटाया जा सकता है.

ऐप्लिकेशन प्रबंधित करें
ऐप्लिकेशन मैनेज करें

प्रोजेक्ट के मालिकाना हक वाले ऐप्लिकेशन पर अन्य लोगों के साथ मिलकर काम करना

डिफ़ॉल्ट रूप से, आपके उपयोगकर्ता नाम से पब्लिश किए गए ऐप्लिकेशन में सिर्फ़ आपके पास बदलाव करने का ऐक्सेस होता है. प्रोजेक्ट के मालिकाना हक वाले ऐप्लिकेशन की मदद से, ऐप्लिकेशन पर मिलकर काम किया जा सकता है. प्रोजेक्ट के मालिकाना हक वाले ऐप्लिकेशन, ऐसे ऐप्लिकेशन होते हैं जिनका मालिकाना हक किसी Cloud प्रोजेक्ट के पास होता है और जिन्हें उसी प्रोजेक्ट के तहत पब्लिश किया जाता है. Earth Engine ऐप्लिकेशन पब्लिशर की आईएएम भूमिका वाला कोई भी व्यक्ति, Cloud प्रोजेक्ट के तहत पब्लिश किए गए ऐप्लिकेशन में बदलाव कर सकता है और उन्हें मिटा सकता है. Earth Engine के IAM रोल के बारे में ज़्यादा जानने के लिए, यहां जाएं.

प्रोजेक्ट के मालिकाना हक वाले ऐप्लिकेशन चालू करने के लिए, "बदलाव करने का ऐक्सेस चुनें" चरण में क्लाउड प्रोजेक्ट विकल्प चुनें. इसके बाद, वह क्लाउड प्रोजेक्ट चुनें जिसका आपको इस्तेमाल करना है. इसके बाद, ऐप्लिकेशन पब्लिश करने की प्रोसेस को सामान्य तरीके से पूरा करें. ऐप्लिकेशन को PROJECT-ID.projects.earthengine.app डोमेन पर पब्लिश किया जाएगा. साथ ही, इसमें वे सभी लोग बदलाव कर सकेंगे जिनके पास क्लाउड प्रोजेक्ट पर Earth Engine Apps Publisher IAM की भूमिका होगी.

प्रोजेक्ट के मालिकाना हक वाला ऐप्लिकेशन पब्लिश करना
प्रोजेक्ट के मालिकाना हक वाले ऐप्लिकेशन को पब्लिश करना

किसी क्लाउड प्रोजेक्ट के लिए ऐप्लिकेशन देखने के लिए, क्लाउड प्रोजेक्ट जोड़ें बटन दबाएं और क्लाउड प्रोजेक्ट चुनें.

कोई क्लाउड प्रोजेक्ट जोड़ना
कोई क्लाउड प्रोजेक्ट जोड़ें

क्लाउड प्रोजेक्ट को अन्य लोगों के साथ शेयर करने के लिए, प्रोजेक्ट शेयर करें बटन दबाएं. इससे आपको प्रोजेक्ट के लिए, Cloud Console के IAM पेज पर ले जाया जाएगा. यहां आपके पास, साथ मिलकर काम करने वाले लोगों को Earth Engine Apps Publisher IAM की भूमिका देने का विकल्प होता है.

प्रोजेक्ट के मालिकाना हक वाले ऐप्लिकेशन चालू करना
प्रोजेक्ट के मालिकाना हक वाले ऐप्लिकेशन में बदलाव करना और उन्हें मिटाना

अक्सर पूछे जाने वाले सवाल

मैं ऐप्लिकेशन की गैलरी से किसी ऐप्लिकेशन को कैसे हटाऊं?
ऐप्लिकेशन के कॉन्फ़िगरेशन पेज पर मौजूद "इस ऐप्लिकेशन को हाइलाइट करें" चेकबॉक्स से यह कंट्रोल किया जाता है कि कोई ऐप्लिकेशन, हाइलाइट किए गए ऐप्लिकेशन पेज पर दिखेगा या नहीं. जिन ऐप्लिकेशन का ऐक्सेस सीमित है उन्हें Google Play पर नहीं दिखाया जा सकता.
क्या मेरा Earth Engine कोड दिख रहा है?
हां, ऐप्लिकेशन को ऐक्सेस करने वाले किसी भी व्यक्ति को. हालांकि, ऐप्लिकेशन पब्लिश होने पर यह साफ़ तौर पर नहीं दिखता है, लेकिन कोई भी व्यक्ति अपने वेब ब्राउज़र पर नेटवर्क ट्रैफ़िक देखकर, आपके ऐप्लिकेशन के लिए JavaScript को आसानी से देख सकता है. उदाहरण के लिए, Chrome में JavaScript को डेवलपर टूल के नेटवर्क पैनल में देखा जा सकता है.
पब्लिश किए गए किसी ऐप्लिकेशन के लिए, "मैप के कुछ हिस्सों को लोड करते समय कोई गड़बड़ी हुई" गड़बड़ी की कुछ संभावित वजहें क्या हैं?
पक्का करें कि आपके ऐप्लिकेशन में इस्तेमाल की गई सभी इमेज या टेबल ऐसेट, सार्वजनिक तौर पर या ऐप्लिकेशन के साथ शेयर की गई हों. ऐसेट शेयर करने वाले डायलॉग बॉक्स में, "कोई भी पढ़ सकता है" विकल्प चुनें या ड्रॉप-डाउन सूची से ऐप्लिकेशन का नाम चुनें. जिन ऐप्लिकेशन को किसी Google ग्रुप के लिए प्रतिबंधित किया गया है उनके साथ कोई ऐसेट शेयर करने पर, वह ऐप्लिकेशन को नहीं दिखेगी. इसके बजाय, ऐसेट को ऐप्लिकेशन के साथ या सार्वजनिक तौर पर शेयर किया जाना चाहिए.
मुझे "ऐप्लिकेशन अभी तैयार नहीं है" पेज क्यों दिख रहा है?
ऐप्लिकेशन बनाने के बाद, सिस्टम में जानकारी को अपडेट होने में कुछ समय लग सकता है. आम तौर पर, यह समस्या कुछ ही मिनटों में हल हो जाती है. अगर गड़बड़ी बनी रहती है, तो कृपया मदद के लिए संपर्क करें.
मेरे ऐप्लिकेशन में, ड्रॉ की गई ज्यामिति क्यों दिख रही हैं?
इससे आपके ऐप्लिकेशन में रेफ़रंस ज्यामिति को दिखाना आसान हो जाता है. साथ ही, ऐसे ऐप्लिकेशन बनाए जा सकते हैं जिनमें उपयोगकर्ता ज्यामिति में बदलाव कर सकते हैं. अगर आपको कुछ खास ज्यामिति नहीं दिखानी हैं या उनमें बदलाव नहीं करना है, तो अलग-अलग ज्यामिति लेयर को छिपाया या लॉक किया जा सकता है. इससे उपयोगकर्ता, आपके ऐप्लिकेशन को पब्लिश करने से पहले उन्हें नहीं देख पाएंगे या उनमें बदलाव नहीं कर पाएंगे. ज़्यादा जानने के लिए, ज्यामिति टूल का दस्तावेज़ देखें.
ऐप्लिकेशन कोटा क्या है?
गलत या ज़्यादा रिसॉर्स इस्तेमाल करने वाली स्क्रिप्ट की वजह से, सेवा की उपलब्धता पर बुरा असर न पड़े, इसके लिए Earth Engine में एक साथ की जाने वाली क्वेरी के लिए, ऐप्लिकेशन के इस्तेमाल का कोटा तय किया गया है. यह कोटा, Earth Engine के हर उपयोगकर्ता के लिए तय किए गए कोटे की तरह ही काम करता है. हालांकि, यह कोटा किसी खास उपयोगकर्ता के बजाय, ऐप्लिकेशन से जुड़ा होता है.
क्या मेरे बनाए गए हर ऐप्लिकेशन का अपना कोटा होता है?
हां, हर ऐप्लिकेशन के लिए अलग कोटा होता है. एपीआई पासकोड से बनाए गए पुराने ऐप्लिकेशन के लिए, कोटा उस क्लाउड प्रोजेक्ट से जुड़ा होता है जिससे आपने ऐप्लिकेशन का एपीआई पासकोड जनरेट किया है. अगर एक ही Cloud प्रोजेक्ट से कई एपीआई पासकोड जनरेट किए जाते हैं, तो वे सभी एक ही इस्तेमाल कोटा शेयर करेंगे.
Cloud बिलिंग खाते की ज़रूरत क्यों होती है? क्या मुझसे ऐप्लिकेशन के लिए शुल्क लिया जाएगा?
हम पर्दे के पीछे होने वाले कई कामों के लिए, Google Cloud Platform का इस्तेमाल करते हैं. Earth Engine ऐप्लिकेशन बनाने के लिए, आपसे कोई शुल्क नहीं लिया जाएगा. हालांकि, Google Cloud Storage मुफ़्त नहीं है. इसलिए, अगर आपको अपने विश्लेषण के नतीजों को Google Cloud Storage में एक्सपोर्ट करना है, तो आपसे शुल्क लिया जा सकता है.
मैं अपने ऐप्लिकेशन के इस्तेमाल और कोटे को बेहतर तरीके से कैसे समझूं?

कोटा खत्म होने पर, Earth Engine HTTP 429: Too Many Requests गड़बड़ियां दिखा सकता है. आम तौर पर, इन गड़बड़ियों को Earth Engine क्लाइंट लाइब्रेरी मैनेज करती है. यह लाइब्रेरी, अनुरोधों को एक्स्पोनेंशियल बैकऑफ़ में रैप करती है और क्वेरी को तब तक फिर से भेजती है, जब तक कि वह पूरी नहीं हो जाती. Earth Engine क्लाइंट लाइब्रेरी, अनुरोध को पांच बार फिर से भेजने की कोशिश करेगी.

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

429 गड़बड़ियां मिलने से बचने के लिए, अपने ऐप्लिकेशन के लिए कैश मेमोरी चालू करें. इसके लिए, कैश मेमोरी में सेव किए जा सकने वाले कुल आंकड़ों को Earth Engine टेबल ऐसेट के तौर पर सेव करें, न कि उन्हें तुरंत कैलकुलेट करें.