Earth Engine, Google Cloud पर काम करता है. इसे ऐक्सेस करने और एपीआई मैनेज करने के लिए, Cloud प्रोजेक्ट की ज़रूरत होती है. Earth Engine के सभी कॉल (चाहे वे Code Editor, क्लाइंट लाइब्रेरी, ऐप्लिकेशन या REST API से हों) को Cloud प्रोजेक्ट के ज़रिए रूट किया जाता है. इससे Cloud Console में, ऐक्सेस कंट्रोल, संसाधन मैनेजमेंट, और इस्तेमाल की निगरानी की जा सकती है.
Earth Engine का ऐक्सेस पाना
Earth Engine का इस्तेमाल करने के लिए, आपको ऐसे Cloud प्रोजेक्ट का ऐक्सेस चाहिए जो:
- Earth Engine API चालू हो,
- व्यावसायिक या गैर-व्यावसायिक इस्तेमाल के लिए रजिस्टर किया गया हो.
- आपको (या उपयोगकर्ता को) सही भूमिकाएं और अनुमतियां मिलती हैं.
प्रोजेक्ट बनाना
नया Cloud प्रोजेक्ट बनाने और रजिस्टर करने के लिए, रजिस्ट्रेशन पेज पर जाएं. इसके अलावा, किसी मौजूदा प्रोजेक्ट को रजिस्टर करने के लिए भी इस पेज पर जाएं.
रजिस्ट्रेशन के दौरान बनाए गए प्रोजेक्ट को Google Cloud Console में मैनेज किया जा सकता है. Earth Engine API को चालू या बंद किया जा सकता है. इसके लिए, Cloud Console पर 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 ऐसेट फ़ोल्डर बनाने का विकल्प होता है. इसे उस Cloud प्रोजेक्ट से जोड़ा जा सकता है जिसे ऐक्सेस करने की अनुमति आपके पास है. इसके लिए,
earthengine create folder
कमांड का इस्तेमाल करें. साथ ही, यहां दिए गए तरीके से पाथ का इस्तेमाल करें.
उदाहरण के लिए:
earthengine create folder projects/my-project/assets/ऐसेट पैनल में प्रोजेक्ट जोड़कर, Code Editor में किसी प्रोजेक्ट के लिए ऐसेट फ़ोल्डर भी बनाया जा सकता है.
अगर आपको प्रोजेक्ट में ऐसेट सेव करनी हैं, तो ही इस फ़ोल्डर को बनाएं.
किसी मौजूदा प्रोजेक्ट का इस्तेमाल करना
अपने संगठन के आईटी कर्मचारियों से, Earth Engine के लिए कॉन्फ़िगर किए गए मौजूदा Cloud प्रोजेक्ट के बारे में पूछें. पक्का करें कि Earth Engine की सेवाओं को ऐक्सेस करने के लिए इस्तेमाल किए जाने वाले Google खाते को प्रोजेक्ट पर सही भूमिकाएं और अनुमतियां दी गई हों.
कोई प्रोजेक्ट तय करना
यहां दिए गए सेक्शन में, Earth Engine की सेवाओं के अलग-अलग इंटरफ़ेस के लिए प्रोजेक्ट तय करने का तरीका बताया गया है.
क्लाइंट लाइब्रेरी (Python, JavaScript)
ee.Initialize() फ़ंक्शन का इस्तेमाल, Earth Engine के उन अनुरोधों के लिए प्रोजेक्ट तय करने के लिए किया जाता है जो Python और JavaScript क्लाइंट लाइब्रेरी से किए जाते हैं. प्रोजेक्ट स्पेसिफ़िकेशन को कॉन्फ़िगर करने के कई तरीके हैं. ज़्यादा जानकारी के लिए, पुष्टि और शुरुआत पेज देखें.
कोड एडिटर
कोड एडिटर के सबसे ऊपर दाएं कोने में मौजूद प्रोफ़ाइल आइकॉन पर क्लिक करें. इसके बाद, मेन्यू से "क्लाउड प्रोजेक्ट बदलें" चुनें. चुने गए डायलॉग बॉक्स में से कोई प्रोजेक्ट चुनें.
Earth Engine ऐप्लिकेशन
Earth Engine ऐप्लिकेशन पब्लिश करते समय, आपसे एक प्रोजेक्ट चुनने के लिए कहा जाएगा, ताकि अनुरोधों को उस प्रोजेक्ट के ज़रिए भेजा जा सके. पब्लिश करने के डायलॉग बॉक्स में दिए गए निर्देशों का पालन करें.
कमांड-लाइन टूल
कमांड-लाइन टूल से Earth Engine कॉल को किसी Cloud प्रोजेक्ट से जोड़ने के लिए, earthengine को कॉल करते समय --project पैरामीटर का इस्तेमाल करें. इसके अलावा, डिफ़ॉल्ट प्रोजेक्ट सेट करने के लिए set_project का इस्तेमाल करें.
REST API
REST API के कॉल को किसी Cloud प्रोजेक्ट से जोड़ने के लिए, पुष्टि किए गए एचटीटीपी कॉल जारी करें. इनमें पुष्टि की प्रोसेस oauth2 मैनेज करता है. लोकल एनवायरमेंट में, gcloud निर्देश का इस्तेमाल किया जा सकता है. किसी Cloud Project से जुड़े सेवा खाते का इस्तेमाल भी किया जा सकता है. सेवा खाते से पुष्टि करने के लिए, 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 मेन्यू () पर जाकर, अपने Cloud प्रोजेक्ट के क्रेडेंशियल मैनेज किए जा सकते हैं. इसके लिए, एपीआई और सेवाएं > क्रेडेंशियल को चुनें. (अगर कहा जाए, तो प्रोजेक्ट चुनें).
प्रोजेक्ट के लिए नया क्लाइंट आईडी बनाने के लिए, + क्रेडेंशियल बनाएं > 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 प्रोजेक्ट मिटाने पर, उससे जुड़ा 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 क्लाइंट
ध्यान दें कि Code Editor का सुरक्षा सैंडबॉक्स, इस कॉल को उस एनवायरमेंट में काम करने से रोकता है.
ee.data.deleteAsset('projects/my-project/assets/my-asset')
कमांड-लाइन टूल
rm निर्देश का इस्तेमाल करें:
earthengine rm projects/my-project/assets/my-assetकोड एडिटर स्क्रिप्ट
Earth Engine Code Editor की स्क्रिप्ट मिटाने के लिए:
कोड एडिटर
कोड एडिटर में मौजूद"स्क्रिप्ट" टैब में जाकर, कोई स्क्रिप्ट या रिपॉज़िटरी चुनें और उसे मिटाएं. किसी रिपॉज़िटरी को मिटाए गए के तौर पर मार्क करने के 30 दिनों के अंदर, उसे वापस नहीं लाया जा सकता.
Git का इस्तेमाल करना
एडवांस उपयोगकर्ता, अपनी स्क्रिप्ट को मैनेज करने के लिए Git का इस्तेमाल कर सकते हैं. वे रिपॉज़िटरी देखने के लिए, https://earthengine.googlesource.com/ पर जाएं जिन्हें देखा जा सकता है.
Earth Engine ऐप्लिकेशन
Earth Engine ऐप्लिकेशन मिटाने के लिए, कोड एडिटर में मौजूद"ऐप्लिकेशन" बटन का इस्तेमाल करके, अपने ऐप्लिकेशन मैनेज करें.
"लिंक पाएं" के रेफ़रंस
कोड एडिटर से "लिंक पाएं" लिंक देखने और मिटाने के लिए, लिंक मैनेज करें पेज का इस्तेमाल करें. इस पेज पर जाने के लिए, "लिंक पाएं" बटन के बगल में मौजूद, ड्रॉप-डाउन मेन्यू में "लिंक मैनेज करें" विकल्प पर जाएं.
गैर-व्यावसायिक ऐक्सेस कॉन्फ़िगर करना
अपने प्रोजेक्ट के लिए, बिना किसी व्यावसायिक मकसद के (बिना शुल्क दिए) Earth Engine का ऐक्सेस सेट अप करने के लिए, आपको Cloud Console में रजिस्ट्रेशन का सवालनामे को भरना होगा. इससे यह पुष्टि की जा सकेगी कि आपका प्रोजेक्ट, Earth Engine का ऐक्सेस पाने की ज़रूरी शर्तें पूरी करता है या नहीं.
पुष्टि
Earth Engine, बिना किसी शुल्क के कंप्यूटिंग संसाधनों का इस्तेमाल करने की अनुमति देता है. इसलिए, Google को हर उस प्रोजेक्ट की पुष्टि करनी होती है जिसे गैर-व्यावसायिक इस्तेमाल के लिए रजिस्टर किया गया है. पुष्टि की प्रोसेस, रजिस्ट्रेशन के दौरान पूरी की जाती है. अगर आपने पुष्टि करने के लिए सवालों के जवाब दिए हैं और यह पता चलता है कि आपका प्रोजेक्ट व्यावसायिक है, तो आपको बिना शुल्क दिए Earth Engine का इस्तेमाल करने की अनुमति नहीं मिलेगी.
कारोबार से जुड़े नहीं, बल्कि अन्य सभी प्रोजेक्ट के लिए, 26 सितंबर, 2025 से Cloud Console में प्रश्नावली भरना ज़रूरी है. हमारा सुझाव है कि आप पुष्टि कराने की प्रोसेस जल्द से जल्द पूरी करें. अगर आपने 26 सितंबर, 2025 से पहले कार्रवाई नहीं की, तो Earth Engine का ऐक्सेस आपके प्रोजेक्ट के लिए रोक दिया जाएगा. यह रोक तब तक लगी रहेगी, जब तक पुष्टि की प्रोसेस पूरी नहीं हो जाती.
फिर से पुष्टि करना
गैर-व्यावसायिक ऐक्सेस वाले सभी प्रोजेक्ट को समय-समय पर ऐक्सेस की पुष्टि करनी होगी.
कमर्शियल ऐक्सेस कॉन्फ़िगर करना
अपने प्रोजेक्ट के लिए, Earth Engine का व्यावसायिक (पैसे चुकाकर) ऐक्सेस सेट अप करने के लिए, आपको रजिस्ट्रेशन पेज का इस्तेमाल करके प्रोजेक्ट को कॉन्फ़िगर करना होगा. साथ ही, बिलिंग खाते पर प्लान चुनना होगा.
व्यावसायिक ऐक्सेस खत्म करना
अगर आपने Earth Engine की सदस्यता सीधे तौर पर ली है और आपको Earth Engine का इस्तेमाल बंद करना है, तो आपको कुछ बदलाव करने होंगे, ताकि आपसे शुल्क न लिया जाए:
सदस्यता के लिए शुल्क लेना बंद करना
- अपने बिलिंग खाते पर Earth Engine की सदस्यता खत्म करने के लिए, आपको "प्लान मैनेज करें" पेज का इस्तेमाल करना होगा. इसे उपयोगकर्ता सेटिंग के ड्रॉप-डाउन मेन्यू से ऐक्सेस किया जा सकता है. यह मेन्यू, Code Editor में सबसे ऊपर दाईं ओर होता है. ऐसा तब किया जा सकता है, जब उस बिलिंग खाते से लिंक किया गया कोई रजिस्टर किया गया Cloud प्रोजेक्ट इस्तेमाल किया जा रहा हो.
बिलिंग खाते के लिए, "प्लान मैनेज करें" पेज को सीधे तौर पर भी ऐक्सेस किया जा सकता है:
https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID"सीमित" प्लान चुनने पर, मौजूदा बिलिंग साइकल के बाद आपके बिलिंग खाते से Earth Engine प्लैटफ़ॉर्म की सदस्यता के लिए कोई शुल्क नहीं लिया जाएगा.
कंप्यूट शुल्क रोकना
- कंप्यूट (ईईसीयू-टाइम) से जुड़े नए शुल्क से बचने के लिए, अपने Cloud प्रोजेक्ट पर Earth Engine API बंद करें. ध्यान दें कि इससे, प्रोसेस किए जा रहे अनुरोध बंद नहीं होते या सेव किए गए ऑब्जेक्ट मिटते नहीं हैं. इसलिए, एपीआई बंद होने के बाद भी आपसे Earth Engine के शुल्क लिए जा सकते हैं.
- एपीआई बंद करने के बारे में जानकारी पाने के लिए, API Console की सहायता टीम से संपर्क करें.
स्टोरेज के लिए शुल्क लेना बंद करना
- Earth Engine में सेव की गई ऐसेट की वजह से, एपीआई बंद होने पर भी लागत लगती रहती है. ऐसेट मिटाने पर, आपको EE स्टोरेज के लिए आगे कोई शुल्क नहीं देना होगा.