Earth Engine का ऐक्सेस

Earth Engine, Google Cloud पर चलता है. इसे ऐक्सेस करने और एपीआई मैनेज करने के लिए, Cloud प्रोजेक्ट की ज़रूरत होती है. Earth Engine के सभी कॉल (चाहे वे कोड एडिटर, क्लाइंट लाइब्रेरी, ऐप्लिकेशन या REST API से किए गए हों) Cloud प्रोजेक्ट के ज़रिए रूट किए जाते हैं. इससे Cloud Console में, ऐक्सेस कंट्रोल, संसाधन मैनेजमेंट, और इस्तेमाल की निगरानी की जा सकती है.

Earth Engine का ऐक्सेस पाना

Earth Engine का इस्तेमाल करने के लिए, आपके पास ऐसे Cloud प्रोजेक्ट का ऐक्सेस होना चाहिए जो:

प्रोजेक्ट बनाना

कोई नया Cloud प्रोजेक्ट बनाने और रजिस्टर करने या किसी मौजूदा प्रोजेक्ट को रजिस्टर करने के लिए, रजिस्ट्रेशन पेज पर जाएं. रजिस्ट्रेशन के बाद, Earth Engine का ऐक्सेस तुरंत चालू हो जाता है.

रजिस्ट्रेशन की प्रोसेस के दौरान बनाए गए प्रोजेक्ट को Google Cloud Console में मैनेज किया जा सकता है. Cloud Console पर मौजूद Earth Engine API पेज से, Earth Engine API को चालू या बंद किया जा सकता है.

मैन्युअल तरीके से किए जाने वाले चरण (रजिस्ट्रेशन पेज की मदद से, इन्हें अपने-आप पूरा किया जा सकता है)

Cloud प्रोजेक्ट बनाना

अगर आपने अब तक Google Cloud Project नहीं बनाया है, तो उसे बनाएं. ऐसा करने के लिए, Cloud Console के प्रोजेक्ट पेज पर जाएं या नीचे दिए गए बटन पर क्लिक करें:

Cloud प्रोजेक्ट बनाएं

Earth Engine API को चालू करना

अपने प्रोजेक्ट के लिए Earth Engine API को चालू करने के लिए, Earth Engine API पेज पर जाने के लिए, नीचे दिए गए बटन पर क्लिक करें:

Earth Engine API को चालू करें

Earth Engine API पेज पर, पक्का करें कि आपने अपना प्रोजेक्ट चुना हो. इसके बाद, चालू करें बटन पर क्लिक करें.

प्रोजेक्ट को वाणिज्यिक या गैर-वाणिज्यिक इस्तेमाल के लिए रजिस्टर करना

अपने प्रोजेक्ट के लिए, यहां दिया गया यूआरएल बदलें. इसके बाद, उस पेज पर जाएं और रजिस्ट्रेशन की प्रोसेस पूरी करें. 

https://code.earthengine.google.com/register?project=my-project

ऐसेट का फ़ोल्डर बनाना (ज़रूरी नहीं)

Earth Engine की ऐसेट का ऐसा फ़ोल्डर बनाया जा सकता है जो किसी ऐसे Cloud प्रोजेक्ट से जुड़ा हो जिसे earthengine create folder कमांड का इस्तेमाल करके ऐक्सेस किया जा सकता है. इसके लिए, यहां बताए गए तरीके से पाथ का इस्तेमाल करें. यहां. उदाहरण के लिए: 

earthengine create folder projects/my-project/assets/

प्रोजेक्ट के लिए, ऐसेट का फ़ोल्डर कोड एडिटर में भी बनाया जा सकता है इसके लिए, ऐसेट पैनल में प्रोजेक्ट जोड़ें.

अगर आपको प्रोजेक्ट में ऐसेट सेव नहीं करनी हैं, तो यह फ़ोल्डर बनाने की ज़रूरत नहीं है.

किसी मौजूदा प्रोजेक्ट का इस्तेमाल करना

Earth Engine के लिए कॉन्फ़िगर किए गए मौजूदा Cloud प्रोजेक्ट के बारे में जानने के लिए, अपनी कंपनी के आईटी स्टाफ़ से संपर्क करें. पक्का करें कि Earth Engine की सेवाओं को ऐक्सेस करने के लिए, जिस Google खाते का इस्तेमाल किया जाएगा उसे प्रोजेक्ट पर सही भूमिकाएं और अनुमतियां मिली हों.

कोई प्रोजेक्ट तय करना

इन सेक्शन में, Earth Engine की सेवाओं के अलग-अलग इंटरफ़ेस के लिए कोई प्रोजेक्ट तय करने का तरीका बताया गया है.

क्लाइंट लाइब्रेरी (Python, JavaScript)

JavaScript प्रोजेक्ट की जानकारी कॉन्फ़िगर करने के कई तरीके हैं. ज़्यादा जानकारी के लिए, पुष्टि और शुरू करने का पेज देखें.

कोड एडिटर

कोड एडिटर के सबसे ऊपर दाएं कोने में मौजूद प्रोफ़ाइल आइकॉन पर क्लिक करें. इसके बाद, मेन्यू से "Cloud प्रोजेक्ट बदलें" चुनें. चुने जाने वाले डायलॉग बॉक्स से कोई प्रोजेक्ट चुनें.

Earth Engine ऐप्लिकेशन

Earth Engine ऐप्लिकेशन पब्लिश करते समय, आपसे अनुरोधों को रूट करने के लिए कोई प्रोजेक्ट चुनने के लिए कहा जाएगा. पब्लिश करने के डायलॉग बॉक्स में दिए गए निर्देशों का पालन करें.

कमांड-लाइन टूल

कमांड-लाइन टूल से किए गए Earth Engine के कॉल को किसी Cloud प्रोजेक्ट से जोड़ने के लिए, --project पैरामीटर का इस्तेमाल करें. इसके अलावा, डिफ़ॉल्ट प्रोजेक्ट सेट करने के लिए, set_project का इस्तेमाल करें.earthengine

REST API

REST API को किए गए कॉल को किसी Cloud प्रोजेक्ट से जोड़ने के लिए, पुष्टि किए गए एचटीटीपी कॉल जारी करें. इनमें पुष्टि की प्रोसेस, oauth2 से पूरी होती है. स्थानीय एनवायरमेंट में, आप gcloud कमांड का इस्तेमाल कर सकते हैं. किसी ऐसे सेवा खाते का भी इस्तेमाल किया जा सकता है जो किसी Cloud प्रोजेक्ट से जुड़ा हो. किसी सेवा खाते से पुष्टि करने के लिए, google.oath.service_account.Credentials.from_service_account_file() का इस्तेमाल करने का उदाहरण देखने के लिए, REST API का क्विकस्टार्ट देखें.

प्रोजेक्ट का ऐक्सेस कॉन्फ़िगर करना

इन सेक्शन में, Earth Engine की सुविधा वाले प्रोजेक्ट को अन्य लोगों और सेवा खातों के लिए इस्तेमाल करने के लिए कॉन्फ़िगर करने का तरीका बताया गया है.

सेवा खाते

सेवा खातों को अपने-आप ऐक्सेस मिल जाता है. इसके लिए, ज़रूरी है कि उनके पैरंट प्रोजेक्ट को रजिस्टर किया गया हो और उसमें Earth Engine API चालू हो. साथ ही, उनके पास प्रोजेक्ट में सही अनुमतियां होनी चाहिए. किसी प्रोजेक्ट पर मौजूद सेवा खातों को Earth Engine का इस्तेमाल करने के लिए कॉन्फ़िगर किया जा सकता है. Earth Engine के साथ सेवा खातों का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, सेवा खातों का पेज देखें.

Google खाते

Cloud प्रोजेक्ट, भूमिकाओं और अनुमतियों को मैनेज करने के लिए Cloud IAM का इस्तेमाल करते हैं. अगर आपको अपने प्रोजेक्ट के ज़रिए, अन्य लोगों को Earth Engine का ऐक्सेस देना है, तो आपको Cloud Console का इस्तेमाल करके, उन्हें सही भूमिकाएं और अनुमतियां देनी होंगी.

OAuth 2.0 क्लाइंट आईडी

किसी प्रोजेक्ट से OAuth 2.0 क्लाइंट आईडी बनाना पड़ सकता है. उदाहरण के लिए, ऐसा ऐप्लिकेशन बनाने के लिए जो उपयोगकर्ता के क्रेडेंशियल को Earth Engine पर पास करता है. अपने Cloud प्रोजेक्ट के क्रेडेंशियल मैनेज करने के लिए, Cloud Console के मेन्यू () पर जाएं और एपीआई और सेवाएं > क्रेडेंशियल को चुनें. (अगर आपसे प्रोजेक्ट चुनने के लिए कहा जाए, तो उसे चुनें).

प्रोजेक्ट के लिए नया क्लाइंट आईडी बनाने के लिए, + क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी > वेब ऐप्लिकेशन पर क्लिक करें.

वेब ऐप्लिकेशन के कॉन्फ़िगरेशन में:

  • अनुमति वाले JavaScript ऑरिजिन तय करें. उदाहरण के लिए:
http://localhost:8080
https://foo-ee-project.appspot.com
  • अनुमति वाले रीडायरेक्ट यूआरआई तय करें. उदाहरण के लिए:
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

OAuth की मदद से, उपयोगकर्ताओं की पुष्टि करने के बारे में ज़्यादा जानें.

आम तौर पर सामने आने वाली स्थितियां

मैं शिक्षा से जुड़ी कोई क्लास ले रहा/रही हूं...

बढ़िया! अगर आपने गैर-वाणिज्यिक प्रोजेक्ट रजिस्टर किया है, तो बिलिंग कॉन्फ़िगरेशन की ज़रूरत नहीं है. इसके बाद, अपने छात्र-छात्राओं को प्रोजेक्ट में जोड़ा जा सकता है.

मैं किसी ऑपरेशनल टीम/वाणिज्यिक संगठन का हिस्सा हूं...

बढ़िया! आपके पास किसी प्रोजेक्ट को वाणिज्यिक इस्तेमाल के लिए रजिस्टर करने और उसमें अपने सहयोगियों को जोड़ने का विकल्प है. कृपया Earth Engine की चुनी गई सदस्यता में, सीट की सीमा पर भी ध्यान दें.

Earth Engine का डेटा मिटाना

खाते के लेवल पर डेटा मिटाना

खाते के लेवल पर डेटा मिटाने से आपके खाते से Earth Engine का सारा डेटा मिट जाएगा.

अगर आपका खाता, Google Workspace के किसी संगठन का हिस्सा है, तो आपके खाते का डेटा एडमिन कंट्रोल करता है. जब कोई एडमिन, Google खाता मिटाता है, तो उससे जुड़ा Earth Engine का सारा डेटा, करीब 30 दिनों के अंदर मिट जाता है.

डेटा मिटने के बाद, Earth Engine की टीम उसे वापस नहीं ला सकती.

Cloud प्रोजेक्ट

किसी Cloud प्रोजेक्ट को मिटाने पर, उससे जुड़ा Earth Engine का डेटा भी मिट जाता है. जैसे, प्रोजेक्ट के रूट में सेव की गई कोई भी ऐसेट, प्रोजेक्ट के लेवल पर मौजूद कोई भी EE ऐप्लिकेशन, निगरानी का डेटा वगैरह. इस प्रोसेस को 30 दिनों तक पलटा जा सकता है. हालांकि, 30 दिनों के बाद, उस डेटा को वापस नहीं लाया जा सकता.

एसेट

अपनी ऐसेट मिटाने का सबसे आसान तरीका है कि आप कोड एडिटर में मौजूद "ऐसेट" टैब का इस्तेमाल करके, Earth Engine की ऐसेट देखें और उन्हें मैन्युअल तरीके से मिटाएं.

प्रोग्राम के ज़रिए, आईडी projects/{project-id}/assets/{asset-id} वाली ऐसेट को मिटाने के लिए (उदाहरण के लिए, projects/my-project/assets/my-asset):

Python क्लाइंट

ee.data.deleteAsset('projects/my-project/assets/my-asset')

JavaScript क्लाइंट

ध्यान दें कि कोड एडिटर का सुरक्षा सैंडबॉक्स, इस एनवायरमेंट में इस कॉल को काम करने से रोकता है.

ee.data.deleteAsset('projects/my-project/assets/my-asset')

कमांड-लाइन टूल

rm कमांड का इस्तेमाल करें:

earthengine rm projects/my-project/assets/my-asset

कोड एडिटर के स्क्रिप्ट

Earth Engine के कोड एडिटर के स्क्रिप्ट मिटाने के लिए:

कोड एडिटर

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

Git का इस्तेमाल करना

बेहतर उपयोगकर्ता, अपनी स्क्रिप्ट मैनेज करने के लिए Git का इस्तेमाल कर सकते हैं. उन डेटा स्टोर करने की जगहों की सूची देखने के लिए जिन्हें देखा जा सकता है, https://earthengine.googlesource.com/ पर जाएं.

Earth Engine ऐप्लिकेशन

Earth Engine के ऐप्लिकेशन मिटाने के लिए, कोड एडिटर में मौजूद "ऐप्लिकेशन" बटन का इस्तेमाल करके, अपने ऐप्लिकेशन मैनेज करें.

कोड एडिटर से, "लिंक पाएं" के लिंक देखने और मिटाने के लिए, लिंक मैनेज करें पेज का इस्तेमाल करें. इस पेज पर जाने के लिए, "लिंक पाएं" बटन के बगल में मौजूद ड्रॉप-डाउन मेन्यू में, "लिंक मैनेज करें" विकल्प पर जाएं.

गैर-वाणिज्यिक ऐक्सेस कॉन्फ़िगर करना

अपने प्रोजेक्ट के लिए, Earth Engine का गैर-वाणिज्यिक (बिना शुल्क वाला) ऐक्सेस सेट अप करने के लिए, आपको Cloud Console में रजिस्ट्रेशन का सवालनामा भरना होगा. इससे यह पुष्टि की जा सकेगी कि आपका प्रोजेक्ट, ज़रूरी शर्तें पूरी करता है या नहीं.

पुष्टि

Earth Engine, कंप्यूट संसाधनों के बड़े हिस्से को बिना शुल्क के ऐक्सेस करने की अनुमति देता है. इसलिए, Google को गैर-वाणिज्यिक ऐक्सेस के लिए रजिस्टर किए गए हर प्रोजेक्ट की पुष्टि की ज़रूरत होती है. पुष्टि की प्रोसेस, रजिस्ट्रेशन के दौरान पूरी की जाती है . अगर आपने पुष्टि का सवालनामा भर दिया है और यह पता चलता है कि आपका प्रोजेक्ट वाणिज्यिक है, तो आपको Earth Engine का इस्तेमाल करने के लिए शुल्क चुकाना होगा.

26 सितंबर, 2025 से, गैर-वाणिज्यिक इस्तेमाल के लिए रजिस्टर किए गए सभी प्रोजेक्ट के लिए, Cloud Console में सवालनामा भरा होना ज़रूरी है. हमारा सुझाव है कि पुष्टि की प्रोसेस जल्द से जल्द पूरी करें. अगर आपने 26 सितंबर, 2025 से पहले कोई कार्रवाई नहीं की, तो पुष्टि की प्रोसेस पूरी होने तक, आपके प्रोजेक्ट के Earth Engine के ऐक्सेस पर रोक लगा दी जाएगी.

फिर से पुष्टि करें

गैर-वाणिज्यिक ऐक्सेस वाले सभी प्रोजेक्ट के लिए, समय-समय पर ऐक्सेस की फिर से पुष्टि करनी होगी.

वाणिज्यिक ऐक्सेस कॉन्फ़िगर करना

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

वाणिज्यिक ऐक्सेस खत्म करना

अगर आप Earth Engine के सीधे ग्राहक हैं और शुल्क चुकाकर Earth Engine का इस्तेमाल बंद करना चाहते हैं, तो शुल्क लगना बंद करने के लिए, आपको कई बदलाव करने होंगे:

  • सदस्यता के शुल्क चुकाना बंद करना

    • अपने बिलिंग खाते पर Earth Engine की सदस्यता खत्म करने के लिए, आपको "प्लान मैनेज करें" पेज का इस्तेमाल करना होगा. इस पेज को, कोड एडिटर के सबसे ऊपर दाएं कोने में मौजूद उपयोगकर्ता सेटिंग के ड्रॉप-डाउन मेन्यू से ऐक्सेस किया जा सकता है. इसके लिए, उस बिलिंग खाते से लिंक किए गए रजिस्टर किए गए Cloud प्रोजेक्ट का इस्तेमाल करना होगा.

    • किसी बिलिंग खाते के लिए, "प्लान मैनेज करें" पेज को सीधे तौर पर भी ऐक्सेस किया जा सकता है:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID

    • "लिमिटेड" प्लान चुनने पर, आपके मौजूदा बिलिंग साइकल के बाद, आपके बिलिंग खाते पर Earth Engine प्लैटफ़ॉर्म की सदस्यता का कोई शुल्क नहीं लगेगा.

  • कंप्यूट के शुल्क चुकाना बंद करना

  • स्टोरेज के शुल्क चुकाना बंद करना

    • Earth Engine की सेव की गई ऐसेट की वजह से, एपीआई बंद होने के बाद भी शुल्क लगता रहता है. अपनी ऐसेट मिटाने पर, EE के स्टोरेज के शुल्क लगना बंद हो जाते हैं.