Earth Engine ऐप्लिकेशन

परिचय

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

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

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

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

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

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

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

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

ऐप्लिकेशन का नया बटन
नया ऐप्लिकेशन बटन

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

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

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

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

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

प्रोजेक्ट के मालिकाना हक वाले ऐप्लिकेशन पर, दूसरों के साथ मिलकर काम करना

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

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

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

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

Google Cloud प्रोजेक्ट जोड़ना
Google Cloud प्रोजेक्ट जोड़ें

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

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

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

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