Earth Engine का ऐक्सेस

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

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

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

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

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

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

मैन्युअल तरीके (रजिस्ट्रेशन पेज से अपने-आप होने वाले तरीके)

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

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

क्लाउड प्रोजेक्ट बनाना

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 ऐसेट फ़ोल्डर बनाने का विकल्प है. यह फ़ोल्डर, उस क्लाउड प्रोजेक्ट से जुड़ा होता है जिसका ऐक्सेस आपके पास है. इसके लिए, earthengine create folder कमांड का इस्तेमाल करें. साथ ही, यहां बताए गए पाथ का इस्तेमाल करें. उदाहरण के लिए:

earthengine create folder projects/my-project/assets/

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

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

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

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

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

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

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

ee.Initialize() फ़ंक्शन का इस्तेमाल, Earth Engine के लिए कोई प्रोजेक्ट तय करने के लिए किया जाता है. यह प्रोजेक्ट, Python और JavaScript क्लाइंट लाइब्रेरी से आने वाले अनुरोधों के लिए तय किया जाता है. प्रोजेक्ट की खास जानकारी को कॉन्फ़िगर करने के कई तरीके हैं. ज़्यादा जानकारी के लिए, पुष्टि और शुरू करने की प्रोसेस पेज देखें.

कोड एडिटर

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

Earth Engine ऐप्लिकेशन

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

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

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

REST API

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

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

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

सेवा खाते

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

Google खाते

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

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

आपको किसी प्रोजेक्ट से OAuth 2.0 क्लाइंट आईडी बनाना पड़ सकता है. उदाहरण के लिए, ऐसा ऐप्लिकेशन बनाने के लिए जो उपयोगकर्ता के क्रेडेंशियल को Earth Engine को पास करता हो. अपने क्लाउड प्रोजेक्ट के क्रेडेंशियल मैनेज करने के लिए, 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 की टीम उसे वापस नहीं ला सकती.

क्लाउड प्रोजेक्ट

जब कोई क्लाउड प्रोजेक्ट मिटाया जाता है, तो उस प्रोजेक्ट से जुड़ा 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 की सदस्यता खत्म करने के लिए, आपको "प्लान मैनेज करें" पेज का इस्तेमाल करना होगा. इस पेज को ऐक्सेस करने के लिए, कोड एडिटर में सबसे ऊपर दाईं ओर मौजूद, उपयोगकर्ता सेटिंग के ड्रॉप-डाउन मेन्यू पर जाएं. ऐसा तब करें, जब उस बिलिंग खाते से लिंक किए गए किसी रजिस्टर किए गए क्लाउड प्रोजेक्ट का इस्तेमाल किया जा रहा हो.
    • बिलिंग खाते के लिए, "प्लान मैनेज करें" पेज को सीधे तौर पर भी ऐक्सेस किया जा सकता है:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID
      
    • "सीमित" प्लान चुनने पर, मौजूदा बिलिंग साइकल के बाद आपके बिलिंग खाते से Earth Engine प्लैटफ़ॉर्म की सदस्यता का कोई शुल्क नहीं लिया जाएगा.

  • कंप्यूट के शुल्क लगने से रोकना

    • कंप्यूट (ईईसीयू-टाइम) से जुड़े नए शुल्क लगने से रोकने के लिए, अपने क्लाउड प्रोजेक्ट पर Earth Engine API को बंद करें. ध्यान दें कि इससे, प्रोसेस किए जा रहे अनुरोधों को खत्म नहीं किया जाता या स्टोर किए गए ऑब्जेक्ट को नहीं मिटाया जाता. इसलिए, एपीआई बंद होने के बाद भी, आपसे Earth Engine के लिए शुल्क लिया जा सकता है.
    • एपीआई बंद करने के बारे में जानकारी पाने के लिए, API Console की सहायता देखें.
  • स्टोरेज के लिए शुल्क देना बंद करना

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