Earth Engine ऐप्लिकेशन

परिचय

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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