Earth Engine User Interface API

‏Earth Engine מספק גישה לווידג'טים של ממשק משתמש (UI) בצד הלקוח באמצעות החבילה ui. אפשר להשתמש בחבילה ui כדי ליצור ממשקים גרפיים לסקריפטים של Earth Engine. ממשקי המשתמש האלה יכולים לכלול ווידג'טים פשוטים של קלט, כמו לחצנים ותיבות סימון, ווידג'טים מורכבים יותר כמו תרשימים ומפות, חלוניות לצורך בקרה על הפריסה של ממשק המשתמש ומטפלי אירועים לאינטראקציות בין ווידג'טים של ממשק המשתמש. תוכלו לקרוא על כל הפונקציות של ה-API של ui בכרטיסייה Docs בצד ימין של עורך הקוד. בדוגמה הבאה נעשה שימוש בחבילה ui כדי להמחיש פונקציות בסיסיות ליצירת ווידג'ט, להגדרת התנהגות כשהמשתמש לוחץ על הווידג'ט ולהצגת הווידג'ט.

שלום עולם!

הדוגמה הזו מייצגת ממשק משתמש פשוט של לחצן שמוצג במסוף. לחיצה על הלחצן תוביל להדפסת 'Hello, world!' במסוף:

Code Editor‏ (JavaScript)

// 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() הוא פונקציה אחרת שתופעל בכל פעם שלוחצים על הלחצן. המנגנון הזה של קריאה לפונקציה (פונקציית 'קריאה חוזרת') כשאירוע מתרחש נקרא 'טיפול באירוע', והוא נמצא בשימוש נרחב בספריית ממשק המשתמש. בדוגמה הזו, כשמקישים על הלחצן, הפונקציה מדפיסה את הטקסט 'Hello, world!' במסוף.

יכולת שינוי

הערה: בניגוד לאובייקטים במרחב השמות ee.*, אובייקטים במרחב השמות ui.* הם משתנים. כך לא צריך להקצות מחדש את האובייקט למשתנה בכל פעם שמפעילים פונקציית מופע על האובייקט. פשוט קריאה לפונקציה תגרום למוטציה (שינוי) של הווידג'ט. הוספת הקוד הבא לדוגמה הקודמת תוביל לרישום קריאה חוזרת (callback) נוספת לאירוע הלחיצה על הלחצן:

Code Editor‏ (JavaScript)

// Set another callback function on the button.
button.onClick(function() {
  print('Oh, yeah!');
});

מעתיקים את הקוד הזה לסוף הדוגמה הקודמת ולוחצים על הפעלה. עכשיו, כשלוחצים על הלחצן, שתי ההודעות מודפסות במסוף.

בדפי ממשק המשתמש תוכלו לקרוא מידע נוסף על פיתוח ממשקי משתמש לסקריפטים של Earth Engine. בדף הווידג'טים מופיע סיור חזותי ומתוארת הפונקציונליות הבסיסית של הווידג'טים בחבילה ui. בדף Panels and Layouts מתוארים קונטיינרים ופלטפורמות ברמה העליונה שאפשר להשתמש בהם כדי לארגן ולסדר ווידג'טים. בדף 'אירועים' מוסבר איך מגדירים את ההתנהגות ואת האינטראקציה של ווידג'טים בממשק המשתמש.