Earth Engine دسترسی به ویجت های رابط کاربری (UI) سمت مشتری را از طریق بسته ui فراهم می کند. از بسته ui برای ایجاد رابط های گرافیکی برای اسکریپت های Earth Engine خود استفاده کنید. این رابط‌ها می‌توانند شامل ویجت‌های ورودی ساده مانند دکمه‌ها و چک‌باکس‌ها، ویجت‌های پیچیده‌تر مانند نمودارها و نقشه‌ها، پانل‌هایی برای کنترل طرح‌بندی رابط کاربری و کنترل‌کننده‌های رویداد برای تعامل بین ویجت‌های رابط کاربری باشند. عملکرد کامل رابط کاربری رابط ui را در برگه Docs در سمت چپ ویرایشگر کد کاوش کنید. مثال زیر از بسته 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() تابع دیگری است که با کلیک روی دکمه اجرا می شود. این مکانیسم یک تابع که هنگام وقوع یک رویداد فراخوانی می شود (عملکرد «بازگشت به تماس») «کنترل کننده رویداد» نامیده می شود و به طور گسترده در کتابخانه UI استفاده می شود. در این مثال، وقتی روی دکمه کلیک می‌شود، تابع «Hello, World!» را چاپ می‌کند. به کنسول
تغییرپذیری
توجه داشته باشید که برخلاف اشیاء در فضای نام ee.* ، اشیاء داخل فضای نام ui.* قابل تغییر هستند. بنابراین لازم نیست هر بار که یک تابع نمونه را روی شیء فراخوانی می کنید، شی را به یک متغیر مجدد اختصاص دهید. به سادگی فراخوانی تابع باعث جهش (تغییر) ویجت می شود. افزودن کد زیر به مثال قبلی منجر به ثبت تماس مجدد برای رویداد کلیک دکمه می شود:
// Set another callback function on the button. button.onClick(function() { print('Oh, yeah!'); });
این کد را در انتهای مثال قبلی کپی کنید و روی Run کلیک کنید. حالا وقتی روی دکمه کلیک می کنید، هر دو پیام در کنسول چاپ می شوند.
از صفحات رابط کاربری برای کسب اطلاعات بیشتر در مورد ساخت رابط های کاربری برای اسکریپت های Earth Engine خود استفاده کنید. صفحه ابزارک ها یک تور بصری ارائه می دهد و عملکرد اصلی ویجت ها را در بسته ui توضیح می دهد. صفحه Panels and Layouts ظروف و طرح‌بندی‌های سطح بالا را توصیف می‌کند که می‌توانید از آنها برای سازماندهی و مرتب کردن ویجت‌ها استفاده کنید. صفحه رویدادها جزئیاتی در مورد پیکربندی رفتار و تعامل ویجت ها در رابط کاربری شما دارد.