Earth Engine, ui पैकेज की मदद से क्लाइंट-साइड यूज़र इंटरफ़ेस (यूआई) विजेट का ऐक्सेस देता है. अपनी Earth Engine स्क्रिप्ट के लिए ग्राफ़िकल इंटरफ़ेस बनाने के लिए, ui पैकेज का इस्तेमाल करें. इन इंटरफ़ेस में, बटन और चेकबॉक्स जैसे आसान इनपुट विजेट, चार्ट और मैप जैसे ज़्यादा जटिल विजेट, यूआई के लेआउट को कंट्रोल करने के लिए पैनल, और यूआई विजेट के बीच इंटरैक्शन के लिए इवेंट हैंडलर शामिल हो सकते हैं. कोड एडिटर की बाईं ओर मौजूद दस्तावेज़ टैब में, ui एपीआई की सभी सुविधाओं को एक्सप्लोर करें. नीचे दिए गए उदाहरण में, ui पैकेज का इस्तेमाल करके, विजेट बनाने के बुनियादी फ़ंक्शन के बारे में बताया गया है. साथ ही, यह भी बताया गया है कि जब उपयोगकर्ता विजेट पर क्लिक करता है, तो विजेट का व्यवहार कैसा होगा.
नमस्कार, विश्व!
इस उदाहरण में, कंसोल में दिखाए गए बटन के आसान यूज़र इंटरफ़ेस (यूआई) को दिखाया गया है. बटन पर क्लिक करने पर, कंसोल में 'नमस्ते, दुनिया!' प्रिंट हो जाता है:
// Make a button widget. var button = ui.Button('Click me!'); // Set a callback function to run when the // button is clicked. button.onClick(function() { print('Hello, world!'); }); // Display the button in the console. print(button);
ध्यान दें कि सबसे पहले, बटन को एक आर्ग्युमेंट के साथ बनाया गया है: उसका लेबल. इसके बाद,
बटन के onClick() फ़ंक्शन को कॉल किया जाता है. onClick() का आर्ग्युमेंट एक और फ़ंक्शन है, जो बटन पर क्लिक करने पर चलेगा. किसी इवेंट के होने पर, फ़ंक्शन को कॉल करने ("कॉलबैक" फ़ंक्शन) के इस तरीके को "इवेंट हैंडलर" कहा जाता है. इसका इस्तेमाल यूज़र इंटरफ़ेस (यूआई) लाइब्रेरी में बड़े पैमाने पर किया जाता है. इस उदाहरण में, बटन पर क्लिक करने पर, फ़ंक्शन कंसोल पर 'नमस्ते, दुनिया!' प्रिंट करता है.
म्यूटेबिलिटी
ध्यान दें कि ee.* नेमस्पेस के ऑब्जेक्ट के उलट, ui.* नेमस्पेस के ऑब्जेक्ट में बदलाव किया जा सकता है. इसलिए, जब भी ऑब्जेक्ट पर कोई इंस्टेंस फ़ंक्शन कॉल किया जाता है, तो आपको ऑब्जेक्ट को वैरिएबल को फिर से असाइन करने की ज़रूरत नहीं होती. फ़ंक्शन को कॉल करने पर, विजेट में बदलाव हो जाएगा. पिछले उदाहरण में यहां दिया गया कोड जोड़ने पर, बटन के क्लिक इवेंट के लिए एक और कॉलबैक रजिस्टर हो जाता है:
// Set another callback function on the button. button.onClick(function() { print('Oh, yeah!'); });
इस कोड को पिछले उदाहरण के आखिर में कॉपी करें और चालू करें पर क्लिक करें. अब बटन पर क्लिक करने पर, दोनों मैसेज कंसोल पर प्रिंट हो जाते हैं.
अपनी Earth Engine स्क्रिप्ट के लिए यूज़र इंटरफ़ेस (यूआई) बनाने के बारे में ज़्यादा जानने के लिए, यूआई पेजों का इस्तेमाल करें. विजेट पेज पर, विज़ुअल टूर की सुविधा मिलती है. साथ ही, ui पैकेज में मौजूद विजेट के बुनियादी फ़ंक्शन के बारे में बताया जाता है. पैनल और लेआउट पेज पर, टॉप-लेवल कंटेनर और लेआउट के बारे में बताया गया है. इनका इस्तेमाल, विजेट को व्यवस्थित करने और व्यवस्थित करने के लिए किया जा सकता है. इवेंट पेज पर, यूज़र इंटरफ़ेस (यूआई) में विजेट के व्यवहार और इंटरैक्शन को कॉन्फ़िगर करने के बारे में जानकारी दी गई है.