Earth Engine कोड एडिटर

code.earthengine.google.com पर मौजूद Earth Engine (EE) कोड एडिटर, Earth Engine JavaScript API के लिए वेब-आधारित IDE है. कोड एडिटर की सुविधाओं को इस तरह से डिज़ाइन किया गया है कि जटिल जियोस्पेशियल वर्कफ़्लो को तेज़ी और आसानी से डेवलप किया जा सके. कोड एडिटर में ये एलिमेंट होते हैं (जैसा कि पहली इमेज में दिखाया गया है):

  • JavaScript कोड एडिटर
  • जियोस्पेशियल डेटासेट को विज़ुअलाइज़ करने के लिए मैप डिसप्ले
  • एपीआई का रेफ़रंस दस्तावेज़ (Docs टैब)
  • Git पर आधारित स्क्रिप्ट मैनेजर (स्क्रिप्ट टैब)
  • कंसोल आउटपुट (कंसोल टैब)
  • लंबे समय तक चलने वाली क्वेरी को मैनेज करने के लिए, टास्क मैनेजर (टास्क टैब)
  • इंटरैक्टिव मैप क्वेरी (इंस्पेक्टर टैब)
  • डेटा संग्रह या सेव की गई स्क्रिप्ट खोजना
  • ज्यामिति ड्रॉइंग टूल

कोड एडिटर के कॉम्पोनेंट

पहली इमेज. code.earthengine.google.com पर, Earth Engine कोड एडिटर के कॉम्पोनेंट का डायग्राम.

कोड एडिटर में कई सुविधाएं हैं, जिनकी मदद से Earth Engine API का फ़ायदा लिया जा सकता है. स्क्रिप्ट टैब पर, स्क्रिप्ट के उदाहरण देखें या अपनी स्क्रिप्ट सेव करें. इंस्पेक्टर टैब की मदद से, मैप पर मौजूद ऑब्जेक्ट के बारे में क्वेरी करें. Google Visualization API का इस्तेमाल करके, नंबर वाले नतीजे दिखाना और चार्ट बनाना. लिंक पाएं बटन का इस्तेमाल करके, अपनी स्क्रिप्ट का यूनीक यूआरएल, सहयोगियों और दोस्तों के साथ शेयर करें. कोड एडिटर में बनाई गई स्क्रिप्ट को प्रोसेस करने के लिए Google को भेजा जाता है. साथ ही, जनरेट की गई मैप टाइल और/या मैसेज को मैप और/या कंसोल टैब में दिखाने के लिए वापस भेजा जाता है. कोड एडिटर को चलाने के लिए, आपके पास एक वेब ब्राउज़र (सबसे अच्छे नतीजों के लिए Google Chrome का इस्तेमाल करें) और इंटरनेट कनेक्शन होना चाहिए. यहां दिए गए सेक्शन में, Earth Engine कोड एडिटर के एलिमेंट के बारे में ज़्यादा जानकारी दी गई है.

JavaScript एडिटर

JavaScript एडिटर:

  • टाइप करते समय कोड को फ़ॉर्मैट करना और हाइलाइट करना
  • समस्याओं वाले कोड को अंडरलाइन करना, सही सिंटैक्स के लिए सुझाव और अन्य सलाह देना
  • कोट, ब्रैकेट, और ब्रैकेट के जोड़े अपने-आप पूरे होने की सुविधा
  • Earth Engine फ़ंक्शन के लिए, कोड पूरा करने के सुझाव दिखाना

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

एपीआई का रेफ़रंस (Docs टैब)

कोड एडिटर की बाईं ओर, दस्तावेज़ टैब होता है. इसमें JavaScript API का पूरा दस्तावेज़ होता है. दस्तावेज़ों को दस्तावेज़ टैब से खोजा और ब्राउज़ किया जा सकता है.

स्क्रिप्ट मैनेजर (स्क्रिप्ट टैब)

स्क्रिप्ट टैब, कोड एडिटर के बाएं पैनल में एपीआई दस्तावेज़ों के बगल में होता है. स्क्रिप्ट मैनेजर, निजी, शेयर की गई, और उदाहरण के तौर पर दी गई स्क्रिप्ट को, Google के होस्ट किए गए Git रिपॉज़िटरी में सेव करता है. डेटा सेव करने की जगहों को ऐक्सेस लेवल के हिसाब से व्यवस्थित किया जाता है. आपकी निजी स्क्रिप्ट, मालिक फ़ोल्डर में मौजूद उस डेटा सेव करने की जगह में सेव होती हैं जिसका मालिकाना हक आपके पास है: users/username/default. मालिक फ़ोल्डर में मौजूद रिपॉज़िटरी का ऐक्सेस सिर्फ़ आपके पास होता है. हालांकि, अगर आपने उन्हें किसी दूसरे व्यक्ति के साथ शेयर किया है, तो वह भी उनका ऐक्सेस पा सकता है. Writer फ़ोल्डर में मौजूद रिपॉज़िटरी, वे रिपॉज़िटरी होती हैं जिनके लिए, उनके मालिक ने आपको लिखने का ऐक्सेस दिया है. Writer फ़ोल्डर में मौजूद रिपॉज़िटरी में नई स्क्रिप्ट जोड़ी जा सकती हैं, मौजूदा स्क्रिप्ट में बदलाव किया जा सकता है या उनके ऐक्सेस में बदलाव किया जा सकता है. हालांकि, उनके मालिक को नहीं हटाया जा सकता. Reader फ़ोल्डर में मौजूद रिपॉज़िटरी, वे रिपॉज़िटरी होती हैं जिनके मालिक ने आपको पढ़ने का ऐक्सेस दिया है. उदाहरण फ़ोल्डर, Google के मैनेज किए जाने वाला एक खास डेटा स्टोर है. इसमें कोड सैंपल मौजूद होते हैं. संग्रह फ़ोल्डर में, ऐसे लेगसी रिपॉज़िटरी होते हैं जिनका ऐक्सेस आपके पास है, लेकिन जिनके मालिक ने उन्हें अब तक स्क्रिप्ट मैनेजर के पुराने वर्शन से माइग्रेट नहीं किया है. स्क्रिप्ट टैब में सबसे ऊपर मौजूद फ़िल्टर बार का इस्तेमाल करके, अपनी स्क्रिप्ट खोजें.

स्क्रिप्ट मैनेजर

दूसरी इमेज. स्क्रिप्ट मैनेजर.

मालिक फ़ोल्डर में नया रिपॉज़िटरी बनाने या किसी रिपॉज़िटरी में फ़ोल्डर और फ़ाइलें बनाने के लिए, बटन पर क्लिक करें. आइकॉन का इस्तेमाल करके स्क्रिप्ट का नाम बदला जा सकता है. साथ ही, आइकॉन का इस्तेमाल करके उन्हें मिटाया जा सकता है. स्क्रिप्ट को खींचकर छोड़ने की सुविधा का इस्तेमाल करके, उन्हें एक से दूसरी जगह ले जाया जा सकता है और फ़ोल्डर में व्यवस्थित किया जा सकता है (दूसरी इमेज). किसी स्क्रिप्ट को किसी दूसरी रिपॉज़िटरी में खींचकर ले जाने पर, वह कॉपी हो जाती है.

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

Git का इस्तेमाल करके, रिपॉज़िटरी को ऐक्सेस किया जा सकता है. इससे, Code Editor के बाहर अपनी स्क्रिप्ट को मैनेज किया जा सकता है और उनमें बदलाव किया जा सकता है. इसके अलावा, उन्हें GitHub जैसे किसी बाहरी सिस्टम के साथ सिंक भी किया जा सकता है. (इस ट्यूटोरियल से Git के बारे में ज़्यादा जानें). रिपॉज़िटरी को क्लोन करने के निर्देशों के लिए, रिपॉज़िटरी के नाम के बगल में मौजूद आइकॉन पर क्लिक करें. ध्यान दें कि earthengine.googlesource.com पर जाकर, उन रिपॉज़िटरी को ब्राउज़ किया जा सकता है जिनका ऐक्सेस आपके पास है. Git के कुछ ऑपरेशन के लिए, आपको पुष्टि करने के क्रेडेंशियल बनाने पड़ सकते हैं. इसके लिए, earthengine.googlesource.com पेज पर सबसे ऊपर मौजूद "पासवर्ड जनरेट करें" लिंक पर जाएं.

स्क्रिप्ट मॉड्यूल

मॉड्यूलर और फिर से इस्तेमाल किए जा सकने वाले कोड लिखना अच्छा होता है. इस तरह के कोड को, कॉपी करके चिपकाए बिना ही स्क्रिप्ट के बीच शेयर किया जा सकता है. मॉड्यूलर डेवलपमेंट की सुविधा चालू करने के लिए, Earth Engine, स्क्रिप्ट के बीच कोड शेयर करने की सुविधा देता है. उदाहरण के लिए, मान लें कि आपने एक ऐसा फ़ंक्शन लिखा है जो काम के ऑपरेशन का एक सेट करता है. फ़ंक्शन के कोड को नई स्क्रिप्ट में कॉपी करने के बजाय, नई स्क्रिप्ट के लिए फ़ंक्शन को सीधे लोड करना आसान होता है. किसी फ़ंक्शन या ऑब्जेक्ट को दूसरी स्क्रिप्ट के लिए उपलब्ध कराने के लिए, उसे exports नाम के खास ऑब्जेक्ट में जोड़ें. किसी दूसरी स्क्रिप्ट में कोड का इस्तेमाल करने के लिए, require फ़ंक्शन का इस्तेमाल करके, किसी दूसरी स्क्रिप्ट से एक्सपोर्ट लोड करें. उदाहरण के लिए, मान लें कि आपने FooModule.js नाम की फ़ाइल में, Modules नाम के फ़ोल्डर में यह मॉड्यूल तय किया है:

/**
 * The Foo module is a demonstration of script modules.
 * It contains a foo function that returns a greeting string.
 * It also contains a bar object representing the current date.
 * @module Modules/FooModule
 */

/**
 * Returns a greeting string.
 * @param {ee.String} arg The name to which the greeting should be addressed
 * @return {ee.String} The complete greeting.
 */
exports.foo = function(arg) {
  return 'Hello, ' + arg + '!  And a good day to you!';
};

/**
 * An ee.Date object containing the time at which the object was created.
 */
exports.bar = ee.Date(Date.now());

exports कीवर्ड को exports.objectToExport के तौर पर इस्तेमाल करने पर ध्यान दें. require फ़ंक्शन का इस्तेमाल करके, इस मॉड्यूल को किसी दूसरी स्क्रिप्ट में इस्तेमाल किया जा सकता है. उदाहरण के लिए:

var Foo = require('users/username/default:Modules/FooModule.js');

print(Foo.doc);

print(Foo.foo('world'));

print('Time now:', Foo.bar);

require फ़ंक्शन को एक स्ट्रिंग की ज़रूरत होती है, जिसमें मॉड्यूल की जगह के ऐब्सलूट पाथ के बारे में बताया गया हो. खास तौर पर, require() का आर्ग्युमेंट, 'pathToRepository:pathToModuleScript' वाले फ़ॉर्मैट में होता है. सिर्फ़ उन रिपॉज़िटरी से मॉड्यूल लोड किए जा सकते हैं जिनका मालिकाना हक आपके पास है और/या जिनका रीड ऐक्सेस आपके पास है. अगर आपको दूसरों को अपने मॉड्यूल का इस्तेमाल करने की अनुमति देनी है, तो आपको उस मॉड्यूल को उन उपयोगकर्ताओं के साथ शेयर करना होगा जिनके पास आपको उसका ऐक्सेस देना है. अपने मॉड्यूल को दस्तावेज़ के तौर पर तैयार किया जा सकता है, ताकि दूसरे लोग इसका इस्तेमाल करना समझ सकें. हमारा सुझाव है कि @module टैग के साथ JSDoc स्टाइल का इस्तेमाल करें.

अपने रेपो में मौजूद किसी फ़ाइल का रेफ़रंस शेयर करने के लिए, यूआरएल पैरामीटर ?scriptPath={repo}:{script} का इस्तेमाल किया जा सकता है. उदाहरण के लिए, https://code.earthengine.google.com/?scriptPath=users/username/utils:utils. यूआरएल पर जाने पर, रेफ़रंस वाली फ़ाइल और उसका रिपॉज़िटरी, स्क्रिप्ट टैब में मौजूद रीडर या लेखक डायरेक्ट्री में जोड़ दिया जाएगा. यह इस बात पर निर्भर करता है कि शेयर किए गए रिपॉज़िटरी के लिए आपके पास किस लेवल की अनुमति है.

ऐसेट मैनेजर (ऐसेट टैब)

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

ऐसेट मैनेजर

तीसरी इमेज. ऐसेट मैनेजर.

कोड एडिटर की स्क्रिप्ट को कोड में बदले गए यूआरएल के ज़रिए शेयर किया जा सकता है. यहां दिए गए सेक्शन में, स्क्रिप्ट यूआरएल जनरेट करने के अलग-अलग तरीकों, उपलब्ध विकल्पों, और स्क्रिप्ट यूआरएल मैनेज करने के तरीकों के बारे में बताया गया है.

कोड एडिटर (चित्र 4) में सबसे ऊपर मौजूद "लिंक पाएं" बटन, स्क्रिप्ट के यूआरएल जनरेट करने और स्क्रिप्ट के व्यवहार के विकल्प सेट करने के लिए इंटरफ़ेस उपलब्ध कराता है. स्नैपशॉट और सेव की गई स्क्रिप्ट के यूआरएल के बीच के अंतर पर ध्यान दें. इनके बारे में यहां बताया गया है.

कॉन्टेंट

चौथी इमेज. "लिंक पाएं" बटन.

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

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

"लिंक पाएं" बटन की दाईं ओर मौजूद ड्रॉपडाउन बटन में, "लिंक मैनेज करें" विकल्प होता है. इस विकल्प पर क्लिक करने से, इंटरफ़ेस के साथ एक नया ब्राउज़र टैब लोड होता है. इसकी मदद से, पहले जनरेट की गई स्क्रिप्ट के लिंक को याद किया जा सकता है, हटाया जा सकता है, और डाउनलोड किया जा सकता है. किसी स्क्रिप्ट को चुनने और डाउनलोड बटन को दबाने पर, आपके सिस्टम में एक ज़िप किया गया फ़ोल्डर ("code_editor_links.zip") डाउनलोड हो जाएगा. इसमें, चुनी गई हर स्क्रिप्ट के लिए .txt फ़ाइल का रेप्रज़ेंटेशन होगा.

ui.url मॉड्यूल, get और set तरीकों की मदद से, स्क्रिप्ट यूआरएल के फ़्रैगमेंट आइडेंटिफ़ायर को प्रोग्राम के हिसाब से बदलने की अनुमति देता है. इसका मतलब है कि Code Editor स्क्रिप्ट और Earth Engine ऐप्लिकेशन, पेज के यूआरएल में वैल्यू पढ़ और सेव कर सकते हैं. नीचे दिए गए दो यूआरएल के आखिर में ध्यान दें. पहला यूआरएल, debug वैरिएबल को false के तौर पर सेट करता है और दूसरा यूआरएल इसे true के तौर पर सेट करता है. दोनों लिंक पर जाएं और ध्यान दें कि पहले यूआरएल में कंसोल में डीबग चेकबॉक्स पर सही का निशान नहीं लगा है और दूसरे यूआरएल में लगा है. इससे हर स्क्रिप्ट का व्यवहार बदल जाता है.

https://code.earthengine.google.com/5695887aad76979388a723a85339fbf2#debug=false;
https://code.earthengine.google.com/5695887aad76979388a723a85339fbf2#debug=true;

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

खोज टूल

अपनी स्क्रिप्ट में इस्तेमाल करने के लिए डेटासेट ढूंढने के लिए, डेटा संग्रह के लिए खोज टूल का इस्तेमाल किया जा सकता है. सर्च टूल, कोड एडिटर में सबसे ऊपर मौजूद टेक्स्ट बॉक्स होता है. इसमें 'जगहें और डेटासेट खोजें...' लिखा होता है खोज बार में किसी डेटा प्रॉडक्ट, सेंसर या किसी अन्य कीवर्ड का नाम टाइप करें. इसके बाद, मैच होने वाली जगहों, रेस्टर, और टेबल डेटासेट की सूची देखने के लिए, बटन पर क्लिक करें. संग्रह में मौजूद किसी डेटासेट के बारे में जानकारी देखने के लिए, किसी भी रेस्टर या टेबल के नतीजे पर क्लिक करें. डेटासेट को सीधे अपनी स्क्रिप्ट में इंपोर्ट करने के लिए, डेटासेट की जानकारी में मौजूद import लिंक या बटन पर क्लिक करें.

आयात

आपकी स्क्रिप्ट में डेटासेट इंपोर्ट करने के नतीजों को, स्क्रिप्ट के सबसे ऊपर मौजूद इंपोर्ट सेक्शन में व्यवस्थित किया जाता है. यह तब तक छिपा रहता है, जब तक कुछ इंपोर्ट नहीं किया जाता. कुछ इंपोर्ट बनाने के बाद, आपको पांचवें चित्र जैसा कुछ दिखेगा. इंपोर्ट को किसी दूसरी स्क्रिप्ट में कॉपी करने या इंपोर्ट को JavaScript में बदलने के लिए, इंपोर्ट हेडर के बगल में मौजूद आइकॉन पर क्लिक करें. इसके बाद, जनरेट किया गया कोड अपनी स्क्रिप्ट में कॉपी करें. आइकॉन की मदद से, इंपोर्ट को मिटाया जा सकता है.

कोड एडिटर इंपोर्ट सेक्शन

पांचवीं इमेज. कोड एडिटर में सबसे ऊपर मौजूद इंपोर्ट सेक्शन.

मैप

एपीआई में मौजूद मैप ऑब्जेक्ट, कोड एडिटर में मैप डिसप्ले को दिखाता है. उदाहरण के लिए, Map.getBounds() कोड एडिटर में दिखने वाला भौगोलिक क्षेत्र दिखाएगा. इस डिसप्ले के लिए, कस्टमाइज़ेशन के अन्य विकल्प देखने के लिए, एपीआई में Map फ़ंक्शन देखें.

लेयर मैनेजर

मैप में जोड़ी गई लेयर के डिसप्ले में बदलाव करने के लिए, मैप के ऊपरी दाएं कोने में मौजूद लेयर मैनेजर का इस्तेमाल करें. खास तौर पर, किसी लेयर को दिखने या न दिखने के बीच टॉगल किया जा सकता है. इसके अलावा, स्लाइडर की मदद से उसकी पारदर्शिता को भी अडजस्ट किया जा सकता है. अलग-अलग लेयर के विज़ुअलाइज़ेशन पैरामीटर में बदलाव करने के लिए, आइकॉन पर क्लिक करें. विज़ुअलाइज़ेशन टूल (छठा चित्र) की मदद से, लेयर के डिसप्ले पैरामीटर को इंटरैक्टिव तरीके से कॉन्फ़िगर किया जा सकता है. डिसप्ले विंडो में इमेज वैल्यू के प्रतिशत या स्टैंडर्ड डिविएशन में, डिसप्ले को लीनियर तरीके से स्ट्रेच करने के लिए, टूल की दाईं ओर मौजूद बटन पर क्लिक करें. यह बटन डिफ़ॉल्ट रूप से, दी गई सबसे कम और सबसे ज़्यादा रेंज में कस्टम स्ट्रेच करता है. आंकड़ों का हिसाब, मैप विंडो के सभी पिक्सल से लगाया जाता है. यह हिसाब, ज़ूम के मौजूदा लेवल पर लगाया जाता है. गामा और/या पारदर्शिता को अडजस्ट करने के लिए, स्लाइडर का इस्तेमाल करें. पैलेट रेडियो बटन पर क्लिक करें और रंग जोड़कर (), रंग हटाकर () या हेक्स स्ट्रिंग की सूची को मैन्युअल रूप से डालकर (), कस्टम पैलेट तय करें. मौजूदा डिसप्ले पर विज़ुअलाइज़ेशन पैरामीटर लागू करने के लिए, लागू करें पर क्लिक करें. अपनी स्क्रिप्ट के इंपोर्ट सेक्शन में, विज़ुअलाइज़ेशन पैरामीटर ऑब्जेक्ट को नए वैरिएबल के तौर पर लोड करने के लिए, इंपोर्ट करें पर क्लिक करें.

लेयर विज़ुअलाइज़ेशन टूल.

छठी इमेज. लेयर विज़ुअलाइज़ेशन टूल.

इंस्पेक्टर टैब

टास्क मैनेजर के बगल में मौजूद इंस्पेक्टर टैब की मदद से, मैप के बारे में इंटरैक्टिव तरीके से क्वेरी की जा सकती है. इंस्पेक्टर टैब चालू होने पर, कर्सर क्रॉसहेयर में बदल जाता है. मैप पर क्लिक करने पर, कर्सर के नीचे जगह और लेयर की वैल्यू दिखती है. उदाहरण के लिए, सातवीं इमेज में इंस्पेक्टर टैब में मैप पर क्लिक करने के नतीजे दिखाए गए हैं. कर्सर की जगह और ज़ूम लेवल के साथ-साथ, मैप पर पिक्सल वैल्यू और ऑब्जेक्ट की सूची भी दिखती है. ऑब्जेक्ट की सूची इंटरैक्टिव होती है. ज़्यादा जानकारी देखने के लिए, इंस्पेक्टर टैब में ऑब्जेक्ट को बड़ा करें.

इंस्पेक्टर टैब

सातवीं इमेज. इंस्पेक्टर टैब, कर्सर की जगह और कर्सर के नीचे मौजूद लेयर की वैल्यू के बारे में जानकारी दिखाता है.

कंसोल टैब

जब स्क्रिप्ट में मौजूद टेक्स्ट, ऑब्जेक्ट या चार्ट जैसी किसी चीज़ को print() किया जाता है, तो उसका नतीजा कंसोल में दिखता है. यह कंसोल इंटरैक्टिव है. इसलिए, प्रिंट किए गए ऑब्जेक्ट के बारे में ज़्यादा जानकारी पाने के लिए, उन्हें बड़ा किया जा सकता है.

Tasks टैब

Earth Engine टास्क ऐसे ऑपरेशन होते हैं जो एपीआई अनुरोध के स्टैंडर्ड टाइम आउट से काफ़ी ज़्यादा समय तक चल सकते हैं. Earth Engine और आस-पास के सिस्टम (Google Cloud Storage, Google Drive वगैरह) में, लंबे समय तक चलने वाले टास्क की मदद से ही आर्टफ़ैक्ट बनाए जा सकते हैं. ये टास्क दो कैटगरी में आते हैं: Import और Export.

इंपोर्ट टास्क का इस्तेमाल, अलग-अलग फ़ाइल टाइप (.csv, .tif वगैरह) से Earth Engine में इमेज अपलोड करने या टेबल अपलोड करने के लिए किया जा सकता है. एक्सपोर्ट करने वाले टास्क का इस्तेमाल, ईई कैलकुलेशन सिस्टम से नतीजे चलाने और लिखने के लिए किया जा सकता है. डेटा एक्सपोर्ट करने के लिए गाइड देखें.

एक्सपोर्ट के लिए, कोड एडिटर में Export फ़ंक्शन के हर कॉल से, टास्क टैब के सबमिट नहीं किए गए टास्क सेक्शन में एक एंट्री अपने-आप भर जाएगी. सर्वर पर एक्सपोर्ट टास्क सबमिट करने के लिए, टास्क के बगल में मौजूद चालू करें बटन पर क्लिक करें. इसके बाद, आपको एक कॉन्फ़िगरेशन डायलॉग दिखेगा. इसमें टास्क के लिए कई तरह के पैरामीटर तय किए जा सकते हैं. अगर टास्क बनाने के समय सभी जानकारी दी गई है, यानी Export के कॉल में सभी ज़रूरी पैरामीटर हैं, तो डायलॉग बॉक्स दिखाए बिना टास्क सबमिट करने के लिए, चालू करें पर क्लिक करते समय ctrl या को दबाकर रखें.

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

सबमिट नहीं किए गए टास्क सिर्फ़ उस पेज पर दिखते हैं जिस पर उन्हें बनाया गया है. पेज बंद होने पर, वे टास्क हट जाते हैं. जब कोई टास्क सर्वर पर सबमिट हो जाता है, तो यूज़र इंटरफ़ेस (यूआई) में उसकी पंक्ति पर क्लिक करने से, टास्क की स्थिति के बारे में ज़्यादा जानकारी और विकल्प मिलेंगे. इनमें, रद्द करने का अनुरोध करने का विकल्प भी शामिल है.

एक साथ कई टास्क देखने और उन्हें रद्द करने के लिए, Cloud Console में Tasks पेज का इस्तेमाल करें. ऐसा मोबाइल क्लाइंट पर भी किया जा सकता है.

प्रोफ़ाइलर

प्रोफ़ाइलर, खास एल्गोरिदम और कैलकुलेशन के अन्य हिस्सों के इस्तेमाल किए गए संसाधनों (सीपीयू टाइम, मेमोरी) के बारे में जानकारी दिखाता है. इससे यह पता लगाने में मदद मिलती है कि स्मृति की सीमाओं की वजह से, स्क्रिप्ट धीरे क्यों चल रही है या काम क्यों नहीं कर रही है. प्रोफ़ाइलर का इस्तेमाल करने के लिए, 'चालू करें' बटन के ड्रॉपडाउन में जाकर, प्रोफ़ाइलर के साथ चलाएं विकल्प पर क्लिक करें. शॉर्टकट के तौर पर, Alt (या Mac पर Option) को दबाकर रखें और 'चालू करें' पर क्लिक करें या Ctrl+Alt+Enter दबाएं. इससे कोड एडिटर की दाईं ओर, प्रोफ़ाइलर टैब चालू हो जाता है. स्क्रिप्ट के चलने पर, प्रोफ़ाइलर टैब में स्क्रिप्ट के लिए इस्तेमाल किए गए संसाधनों की टेबल दिखेगी. प्रोफ़ाइलिंग के बिना, चालू करें बटन पर क्लिक करने से, प्रोफ़ाइलर टैब हट जाएगा और प्रोफ़ाइलर बंद हो जाएगा.

प्रोफ़ाइलर के आउटपुट का ब्रेकडाउन देखने के लिए, कंप्यूटेशन की खास जानकारी पेज देखें.

ज्यामिति टूल

स्क्रीन पर ड्रॉ करके भी अपनी स्क्रिप्ट में ज्यामिति इंपोर्ट की जा सकती है. ज्यामिति बनाने के लिए, मैप डिसप्ले (चित्र 8) के ऊपरी बाएं कोने में मौजूद ज्यामिति ड्रॉइंग टूल का इस्तेमाल करें. पॉइंट बनाने के लिए, प्लेसमार्क आइकॉन का इस्तेमाल करें. लाइनें बनाने के लिए, लाइन आइकॉन का इस्तेमाल करें. पॉलीगॉन बनाने के लिए, पॉलीगॉन आइकॉन का इस्तेमाल करें. रेक्टैंगल बनाने के लिए, रेक्टैंगल आइकॉन का इस्तेमाल करें. (ध्यान दें कि रेक्टैंगल, प्लैनर ज्यामिति हैं. इसलिए, उन्हें लाइनों और पॉलीगॉन जैसी जियोडेसिक ज्यामिति वाली लेयर पर नहीं रखा जा सकता.)

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

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

अपनी स्क्रिप्ट में ज्यामिति को इंपोर्ट करने के तरीके को कॉन्फ़िगर करने के लिए, मैप पर ज्यामिति इंपोर्ट सेक्शन में या कोड एडिटर के इंपोर्ट सेक्शन में, लेयर के बगल में मौजूद आइकॉन पर क्लिक करें. ज्यामिति लेयर की सेटिंग टूल, डायलॉग बॉक्स में दिखेगा. यह बॉक्स, नौवीं इमेज की तरह दिखेगा. ध्यान दें कि खींचे गए आकार, ज्यामिति, सुविधाओं या सुविधाओं के कलेक्शन के तौर पर इंपोर्ट किए जा सकते हैं. ज्यामिति इंपोर्ट सेटिंग की मदद से, लेयर को दिखाने के लिए इस्तेमाल होने वाले रंग को बदला जा सकता है. साथ ही, अगर लेयर को Feature या FeatureCollection के तौर पर इंपोर्ट किया गया है, तो उसमें प्रॉपर्टी जोड़ी जा सकती हैं या लेयर का नाम बदला जा सकता है.

जियोमेट्री कॉन्फ़िगरेशन टूल

नौवीं इमेज. ज्यामिति कॉन्फ़िगरेशन टूल.

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

मदद चाहिए!

डेवलपर गाइड, अन्य सहायता फ़ोरम, और कोड एडिटर के बारे में जानकारी देने वाले टूर के लिंक देखने के लिए, कोड एडिटर के सबसे ऊपर दाईं ओर मौजूद बटन पर क्लिक करें. साथ ही, कोडिंग, कोड चलाने, और मैप पर डेटा दिखाने में मदद करने वाले कीबोर्ड शॉर्टकट की सूची भी देखें. गड़बड़ी की शिकायत करने, किसी नई सुविधा का अनुरोध करने, डेटासेट का सुझाव देने या किसी जवाब की ज़रूरत न होने पर सुझाव/राय/शिकायत भेजने के लिए, बटन पर क्लिक करें.