יש מגוון ווידג'טים שאפשר להשתמש בהם כדי ליצור ממשקי משתמש. הווידג'טים האלה כוללים
לחצנים, תיבות סימון, פסי הזזה, תיבות טקסט ותפריטי בחירה. אפשר להדפיס ווידג'טים או להוסיף אותם ללוח רק פעם אחת. בקטעים הבאים מוסברים הפונקציונליות, המראה והתחושה הבסיסיים של הווידג'טים. בקטע "סגנון" מוסבר איך לעצב את הווידג'טים. בדוגמאות הבאות פשוט מדפיסים את הווידג'טים במסוף באמצעות print(). במאמר לוחות ופריסות מוסבר איך מוסיפים ווידג'טים ללוחות.
ui.Label
תוויות הן פשוט אזורים שבהם מוצג טקסט. לדוגמה, הקוד הבא מדפיס תווית:
Code Editor (JavaScript)
var label = ui.Label('Cool label!'); print(label);
הוא נראה בערך ככה:
כדי לפצל תוויות ארוכות, מוסיפים תו של שורה חדשה (\n)
ומגדירים את הארגומנט של מאפיין הסגנון whiteSpace
לערך 'pre':
print(ui.Label('Here is a:\nnew line', {whiteSpace: 'pre'}));
ui.Button
כפתור הוא ווידג'ט אינטראקטיבי בממשק המשתמש שאפשר ללחוץ עליו. אפשר לציין פונקציה שתופעל (פונקציית ה-callback) כשמשתמש לוחץ על הכפתור. (מידע נוסף על טיפול באירועים באמצעות פונקציות קריאה חוזרת זמין בדף האירועים). בדוגמה הבאה, כשלוחצים על הכפתור, המערכת מדפיסה את המרכז הנוכחי של המפה:
Code Editor (JavaScript)
var button = ui.Button({ label: 'Get Map Center', onClick: function() { print(Map.getCenter()); } }); print(button);
הוא נראה בערך ככה:
ui.Checkbox
תיבת סימון היא ווידג'ט שמאפשר למשתמש לסמן (או לבטל את הסימון) של תיבה. כשהמצב של תיבת הסימון משתנה, פונקציות קריאה חוזרת (callback) שרשומות לווידג'ט מקבלות ערך בוליאני שמציין אם תיבת הסימון מסומנת עכשיו. לדוגמה:
Code Editor (JavaScript)
var checkbox = ui.Checkbox('Show SRTM layer', true); checkbox.onChange(function(checked) { // Shows or hides the first map layer based on the checkbox's value. Map.layers().get(0).setShown(checked); }); Map.addLayer(ee.Image('CGIAR/SRTM90_V4')); print(checkbox);
תיבת הסימון המודפסת אמורה להיראות בערך כך:
שימו לב: סימון התיבה מפעיל שכבה שמוצגת במפה. כמו רכיבים אחרים בממשק המשתמש, אפשר לשנות את המפה של עורך הקוד באופן פרוגרמטי. מידע נוסף על האובייקט מפה זמין בדף "חלוניות ופריסות".
ui.Slider
פס הזזה הוא ווידג'ט שמאפשר למשתמשים להזיז את הפס כדי לקבל מספר בטווח של פס ההזזה. מגדירים את הטווח באמצעות ה-constructor או באמצעות הגדרת המאפיינים של פס ההזזה. בדוגמה הבאה, משתמשים בפס ההזזה כדי להגדיר את האטימות של השכבה הראשונה במפה:
Code Editor (JavaScript)
var slider = ui.Slider(); slider.setValue(0.9); // Set a default value. slider.onChange(function(value) { Map.layers().get(0).setOpacity(value); }); Map.addLayer(ee.Image(255), {palette: 'blue'}); print(slider);
הסליידר אמור להיראות בערך כך:
שימו לב שהערך של פס ההזזה מוצג משמאל לפס ההזזה.
ui.DateSlider
הווידג'ט DateSlider דומה לווידג'ט Slider, אבל מטפל בתאריכים באופן מפורש. כך נראה DateSlider שמוגדר לבחירת יום ביוני 2018:
הפונקציה DateSlider שימושית לסינון אוספים, כמו בדוגמה הבאה, שבה נוצרת תמונה משולבת שנתית על סמך DateRange שמוגדר ב-DateSlider:
Code Editor (JavaScript)
// Use a DateSlider to create annual composites of this collection. var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1'); // Use the start of the collection and now to bound the slider. var start = ee.Image(collection.first()).date().get('year').format(); var now = Date.now(); var end = ee.Date(now).format(); // Run this function on a change of the dateSlider. var showMosaic = function(range) { var mosaic = ee.Algorithms.Landsat.simpleComposite({ collection: collection.filterDate(range.start(), range.end()) }); // Asynchronously compute the name of the composite. Display it. range.start().get('year').evaluate(function(name) { var visParams = {bands: ['B4', 'B3', 'B2'], max: 100}; var layer = ui.Map.Layer(mosaic, visParams, name + ' composite'); Map.layers().set(0, layer); }); }; // Asynchronously compute the date range and show the slider. var dateRange = ee.DateRange(start, end).evaluate(function(range) { var dateSlider = ui.DateSlider({ start: range['dates'][0], end: range['dates'][1], value: null, period: 365, onChange: showMosaic, style: {width: '180px'} }); Map.add(dateSlider.setValue(now)); }); // Initialize the map location at southern Africa. Map.setCenter(23.861, -27.144, 6);
ui.Textbox
תיבת טקסט היא מקום שבו אפשר לאסוף טקסט שהמשתמשים מזינים. לדוגמה:
Code Editor (JavaScript)
var textbox = ui.Textbox({ placeholder: 'Enter text here...', onChange: function(text) { print('So what you are saying is ' + text + '?'); } }); print(textbox);
תיבת הטקסט אמורה להיראות בערך כך:
שימו לב שהקריאה החוזרת מופעלת רק כשהמשתמש מסיים להזין טקסט (ולוחץ על return), או כשהמשתמש לוחץ מחוץ לתיבת הטקסט.
ui.Select
הווידג'ט של הבחירה מייצג תפריט נפתח של אפשרויות שהמשתמש יכול לבחור מתוכן. הדוגמה הבאה ממחישה תפריט נפתח שמאפשר למשתמש לבחור מיקום:
Code Editor (JavaScript)
var places = { MTV: [-122.0849, 37.3887], PEK: [116.4056, 39.9097], ZRH: [8.536, 47.376] }; var select = ui.Select({ items: Object.keys(places), onChange: function(key) { Map.setCenter(places[key][0], places[key][1]); } }); // Set a place holder. select.setPlaceholder('Choose a location...'); print(select);
הווידג'ט לבחירה אמור להיראות בערך כך:
ui.Chart
התרשימים בחבילה ui.Chart פועלים באופן דומה לתרשימים בחבילה Chart. באופן ספציפי, ui.Chart הוא מעטפת דקה
מסביב למכונה של ChartWrapper של Google Visualization API.
למידע נוסף על שינוי אובייקטים של ChartWrapper, עיינו במקור המידע הזה. מידע נוסף על פונקציות העזר של התרשימים ב-Earth Engine זמין במסמכי התיעוד של התרשימים.
ui.Thumbnail
אפשר להשתמש בווידג'ט של התמונה הממוזערת כדי לראות תצוגה מקדימה של אובייקטים מסוג ee.Image ו-ee.ImageCollection. כשמזינים ee.Image, הווידג'ט יציג תמונה סטטית. כשמזינים ee.ImageCollection, הוא יציג אנימציה עם פריים אחד לכל תמונה בקלט. כמו ב-ee.Image.getThumbURL() וב-ee.ImageCollection.getVideoThumbURL(), אפשר לציין פרמטרים כדי לשלוט בפורמט ובמידות של התמונה הממוזערת שנוצרת:
Code Editor (JavaScript)
// Create a box around an area in the Brazilian Amazon. var box = ee.Geometry.Polygon([[ [-62.9564, 2.5596], [-62.9550, 2.4313], [-62.8294, 2.4327], [-62.8294, 2.5596] ]]); // Visualize the image in RGB. var image = ee.Image('LANDSAT/LE07/C02/T1_L2/LE07_233058_20011113') .select(['SR_B[1-3]']) // blue, green, red reflectance .multiply(0.0000275).add(-0.2) // apply scaling factors .visualize({ bands: ['SR_B3', 'SR_B2', 'SR_B1'], min: 0, max: 0.12, gamma: 1.3 }); // Print a thumbnail to the console. print(ui.Thumbnail({ image: image, params: {dimensions: '256x256', region: box, format: 'png'}, style: {height: '300px', width: '300px'} }));
התמונה הממוזערת אמורה להיראות בערך כך:
ui.Map
ui.Map הוא ווידג'ט של מפה. (למעשה, המפה שמוגדרת כברירת מחדל בעורך הקוד היא מופע של המחלקה הזו). כמו ווידג'טים אחרים, אפשר להדפיס מפה למסוף. לשנות את תוכן המפה על ידי ניקוי, קבלה או הגדרה של שכבות נפרדות. בדוגמה הבאה מודפסת מפה למסוף שמציגה את גבולות המפה של עורך הקוד:
Code Editor (JavaScript)
// Make a little map. var map = ui.Map(); // Make the little map display an inset of the big map. var createInset = function() { var bounds = ee.Geometry.Rectangle(Map.getBounds()); map.centerObject(bounds); map.clear(); map.addLayer(bounds); }; // Run it once to initialize. createInset(); // Get a new inset map whenever you click on the big map. Map.onClick(createInset); // Display the inset map in the console. print(map);
המפה המוקטנת אמורה להיראות בערך כך:
בדוגמה הזו, המשתמש צריך ללחוץ על המפה הגדולה כדי שהמפה הקטנה תציג את המיקום.
אפשר גם לשנות שכבות במפה על ידי קריאה ל-layers() במופע של המפה. הפונקציה layers() מחזירה ui.data.ActiveList, אובייקט דמוי מערך. כשמשנים את הסגנון, גם השכבות במפה משתנות. מידע נוסף זמין בקטע ui.Map.Layer.
ui.Map.Layer
שכבה היא לא ווידג'ט שאפשר לעצב כמו ui.Button. זהו רק ייצוג נתונים של השכבה במפה. בדוגמה הבאה אפשר לראות איך לעדכן מפה על ידי יצירת שכבה ועדכון המאפיינים של השכבה על סמך קלט של משתמשים:
Code Editor (JavaScript)
var consoleMap = ui.Map({ lon: -2.0174, lat: 48.6474, zoom: 13 }); // Create a Layer from this Sentinel-2 image var image = ee.Image('COPERNICUS/S2_HARMONIZED/20150821T111616_20160314T094808_T30UWU'); var visParams = {bands: ['B4', 'B3', 'B2'], max: 2048, gamma: 1}; var layer = ui.Map.Layer(image, visParams); // Update the map by updating the layers list. var layers = consoleMap.layers(); layers.add(layer); // Make a textbox to accept a gamma value. // Update the layer when the gamma value is entered. var gammaBox = ui.Textbox({ value: 1, onChange: function(value) { // visParams is NOT an ActiveDictionary, so set it again. visParams.gamma = value; layer.setVisParams(visParams); } }); print(ui.Label('Enter a gamma value:')); print(gammaBox); print(consoleMap);
ui.Map.CloudStorageLayer
אם אתם רוצים להציג (למשל באפליקציה) שכבה שעלות החישוב שלה גבוהה יחסית, כדאי לייצא את הנתונים לקטגוריה של Cloud Storage משיקולי ביצועים. השכבות הסטטיות האלה, שמיועדות להצגה בלבד, יכולות לשפר את מהירות התגובה של האפליקציות והסקריפטים. אפשר ליצור שכבת תצוגה סטטית למטרה הזו באמצעות Export.map.toCloudStorage().
כדי להשתמש בקבוצת משבצות שיוצאה בעבר על ידי Export.map.toCloudStorage(), יוצרים ui.Map.Layer חדש מקטגוריה ומנתיב ספציפיים של Cloud Storage:
Map.add(ui.Map.CloudStorageLayer({ bucket: 'earthenginepartners-hansen', path: 'tiles/gfc_v1.4/loss_year', maxZoom: 12, suffix: '.png' }));
כשמריצים סקריפט שטוען שכבת Cloud Storage, יכול להיות שתופיע הודעת האזהרה הבאה:
ui.Map.DrawingTools
יש קבוצה של כלי שרטוט גיאומטריים שנוספים כברירת מחדל ל-Map
בעורך הקוד. אפשר לשנות את ההתנהגות של הכלים האלה ב-Map שמוגדר כברירת מחדל באמצעות קריאה ל-Map.drawingTools(). לדוגמה, כדי להסתיר את כלי השרטוט:
Code Editor (JavaScript)
Map.drawingTools().setShown(false);
כברירת מחדל, מפות חדשות שנוצרות לא כוללות כלי שרטוט, אבל אפשר להפעיל אותם על ידי קריאה ל-method drawingTools() במפה:
Code Editor (JavaScript)
var map = ui.Map(); // Prints true since drawingTools() adds drawing tools to the map. print(map.drawingTools().getShown()); // Replace the default Map with the newly created map. ui.root.widgets().reset([map]);
שכבות הגיאומטריה שנוצרו על ידי כלי השרטוט מוכנסות ל-ui.data.ActiveList, שאפשר לגשת אליו באמצעות קריאה ל-Map.drawingTools().layers(). רשימת שכבות הגיאומטריה מגיבה לאירועים כמו רשימות פעילות אחרות, למשל רשימת השכבות ב-Map שמוחזרת על ידי Map.layers(). בדוגמה הבאה אפשר לראות איך מגדירים את החשיפה של שכבות הגיאומטריה שמשורטטות על ידי הכלים (שמוצגות כברירת מחדל):
Code Editor (JavaScript)
Map.drawingTools().layers().forEach(function(layer) { layer.setShown(false); });
כדי להוסיף שכבה באופן פרוגרמטי לכלי השרטוט, אפשר להפעיל את ה-method addLayer בכלי השרטוט או להוסיף שכבה ישירות לרשימת השכבות:
Code Editor (JavaScript)
var geometries = [ee.Geometry.Point([0,0]), ee.Geometry.Rectangle([[0,0], [1,1]])]; Map.drawingTools().addLayer(geometries, 'my_geometry1', 'red'); var layer = ui.Map.GeometryLayer(geometries, 'my_geometry2', 'blue'); Map.drawingTools().layers().add(layer);
המצב של כלי השרטוט נשמר גם כשמפרסמים אפליקציה. אם כלי השרטוט מוצגים או מוסתרים, הם יוצגו או יוסתרו גם באפליקציה. גם הגיאומטריות בייבוא נשמרות באפליקציה.
ui.Map.GeometryLayer
GeometryLayer הוא אוסף של צורות גיאומטריות שפועל כGeometry, GeometryCollection או FeatureCollection יחיד, שנוסף לקטע הייבוא בחלק העליון של הסקריפט ואפשר להפנות אליו בקוד.
ל-GeometryLayers שנוצרו באמצעות כלי השרטוט יש התנהגות שמוגדרת כברירת מחדל, ואפשר לשנות אותה באמצעות פונקציות חדשות של קריאה חוזרת (callback). לדוגמה, נניח שאתם רוצים ששינויים אינטראקטיביים בגיאומטריות יפעילו אירוע. כדי להטמיע התנהגות מסוימת, אפשר להגדיר את השיטות onEdit(), onErase() או onDraw() בכלים כדי להגיב לפעולות של המשתמשים.
בדוגמה הבאה מוסבר איך להפעיל חישוב ולעדכן תווית עם תוצאת החישוב כשהמשתמש מוסיף, עורך או מוחק גיאומטריה:
Code Editor (JavaScript)
// Load elevation data. var srtm = ee.Image('NASA/NASADEM_HGT/001').select('elevation'); Map.addLayer(srtm, {min: 0, max: 5000}, 'SRTM'); // Make a label to display mean elevation at drawn points. var label = new ui.Label('Draw points to calculate mean elevation'); var inspector = new ui.Panel([label]); Map.add(inspector); // Don't make imports that correspond to the drawn points. Map.drawingTools().setLinked(false); // Limit the draw modes to points. Map.drawingTools().setDrawModes(['point']); // Add an empty layer to hold the drawn points. Map.drawingTools().addLayer([]); // Set the geometry type to be point. Map.drawingTools().setShape('point'); // Enter drawing mode. Map.drawingTools().draw(); // This function gets called when the geometry layer changes. // Use debounce to call the function at most every 100 milliseconds. var getAverageElevation = ui.util.debounce(function() { var points = Map.drawingTools().layers().get(0).toGeometry(); var elevation = srtm.reduceRegion({ reducer: ee.Reducer.mean(), geometry: points, scale: 30 }).get('elevation'); // Asynchronously evaluate the mean elevation. elevation.evaluate(showElevation); }, 100); // Set the callback function on changes of the geometry layer. Map.drawingTools().onEdit(getAverageElevation); Map.drawingTools().onDraw(getAverageElevation); Map.drawingTools().onErase(getAverageElevation); // Set the label to the result of the mean reduction. function showElevation(elevation) { inspector.clear(); var elevationLabel = ui.Label('Mean elevation: ' + elevation); inspector.add(elevationLabel); }
שימו לב שהמקש setLinked() משמש להחלפת המצב של החיבור בין כלי השרטוט הגיאומטריים לבין הקטע Imports של עורך הקוד. בדוגמה הזו, כלי הגיאומטריה לא מקושרים כדי למנוע יצירה של ייבואים. toGeometry משמש להמרת השכבה ל-ee.Geometry. אם השכבה המיובאת מייצגת Feature או FeatureCollection, אפשר לאחזר את אובייקט ה-EE הבסיסי באמצעות getEeObject(). שימו לב גם לשימוש ב-ui.util.debounce כדי למנוע מכל תנועה של גיאומטריה להפעיל את פונקציית הקריאה החוזרת. באופן ספציפי, הפונקציה לא תופעל עד שיעברו 100 אלפיות השנייה מאז האירוע האחרון. כך
אפשר לוודא שהפונקציה פועלת רק כשהמשתמש השלים את פעולת העריכה.
שכבת גיאומטריה בייבוא משויכת ל-Geometry או ל-GeometryCollection, ולכן היא יכולה להכיל רק גיאומטריות עם אותו מצב גיאודזי, כי פורמט GeoJSON מאפשר רק מצב גיאודזי אחד לאוסף הגיאומטריות (מידע נוסף זמין בדף גיאומטריות גיאודזיות לעומת גיאומטריות מישוריות). כדי להוסיף גיאומטריות גיאודזיות ומישוריות לאותה שכבה, צריך להמיר את שכבת הגיאומטריה לFeatureCollection באמצעות לחיצה על סמל גלגל השיניים לצד שם השכבה. עם זאת, המרה חזרה ל-Geometry תגרום לשגיאה. כדי למנוע את זה, צריך להמיר
ל-FeatureCollection או למחוק צורות גיאומטריות עד שתישאר רק צורה גיאודזית אחת
בשכבה.
ui.Map.Linker
בדומה לשכבה, מקשר הוא לא ווידג'ט שאפשר לעצב. זהו כלי שפועל מאחורי הקלעים
ואפשר להשתמש בו כדי לסנכרן את התנועה של כמה מופעים של ui.Map:
Code Editor (JavaScript)
// Add two maps to the screen. var left = ui.Map(); var right = ui.Map(); ui.root.clear(); ui.root.add(left); ui.root.add(right); // Link the "change-bounds" event for the maps. // When the user drags one map, the other will be moved in sync. ui.Map.Linker([left, right], 'change-bounds');
ui.SplitPanel
ui.SplitPanel שימושי להשוואה בין דברים זה לצד זה. היתרון של ui.SplitPanel על פני שני חלונות רגילים הוא שאפשר להשתמש בידית כדי לעבור בין החלונות ב-ui.SplitPanel. בדוגמה הבאה משתמשים ב-ui.SplitPanel כדי להציג את ההבדלים הספקטרליים של צלקות כווייה:
Code Editor (JavaScript)
// Load an image of the Santa Rosa, California 2017 fires. var image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_045033_20171011'); // Add a color-SWIR composite to the default Map. Map.setCenter(-122.6624, 38.5011, 12); Map.addLayer(image, {bands: ['B7', 'B5', 'B3'], max: 0.3}, 'color-SWIR'); // Make another map and add a color-NIR composite to it. var linkedMap = ui.Map(); linkedMap.addLayer(image, {bands: ['B5', 'B4', 'B3'], max: 0.3}, 'color-NIR'); // Add a thermal image to the map. linkedMap.addLayer(image, { bands: ['B11'], min: 290, max: 305, palette: ['gray', 'white', 'yellow', 'red'] }, 'Thermal'); // Link the default Map to the other map. var linker = ui.Map.Linker([ui.root.widgets().get(0), linkedMap]); // Make an inset map and add it to the linked map. var inset = ui.Map(); inset.style().set({position: 'bottom-right', width: '300px', height: '250px'}); inset.setControlVisibility({all: false, mapTypeControl: true}); linkedMap.add(inset); // Register a function to the linked map to update the inset map. linkedMap.onChangeBounds(function() { var bounds = ee.Geometry.Rectangle(Map.getBounds()); inset.centerObject(bounds); inset.layers().set(0, bounds); }); // Create a SplitPanel which holds the linked maps side-by-side. var splitPanel = ui.SplitPanel({ firstPanel: linker.get(0), secondPanel: linker.get(1), orientation: 'horizontal', wipe: true, style: {stretch: 'both'} }); // Set the SplitPanel as the only thing in root. ui.root.widgets().reset([splitPanel]);
שימו לב שהפרמטר wipe מוגדר לערך true ב-constructor של ui.SplitPanel כדי לאפשר למשתמש להחליק את נקודת האחיזה קדימה ואחורה בין שתי התצוגות החזותיות.
ווידג'טים של סגנון
הסגנון של הווידג'ט נשלט על ידי מילון מאפייני הסגנון של הווידג'ט. כדי לגשת למילון, אפשר להפעיל את style() בווידג'ט. האובייקט שמוחזר על ידי style() הוא מופע של ui.data.ActiveDictionary. כלומר, הגדרת המאפיינים של מילון הסגנונות מעדכנת באופן אוטומטי את האופן שבו הווידג'ט מוצג. המפתחות המותרים לשימוש במילון הסגנונות של כל ווידג'ט מפורטים במסמכי העזר של הווידג'ט לקריאה ל-style().
אפשר להגדיר את הסגנונות של הווידג'ט באמצעות ה-constructor, על ידי קריאה ל-style().set() או על ידי קריאה ל-style() עם ארגומנט של מילון. לדוגמה:
Code Editor (JavaScript)
var redLabel = ui.Label('Big, Red Label'); redLabel.style().set('color', 'red'); redLabel.style().set('fontWeight', 'bold'); redLabel.style().set({ fontSize: '32px', padding: '10px' }); print(redLabel);
שימו לב שבדוגמה הזו, הסגנון של התווית נקבע קודם על ידי קריאה ל-style().set() עם ארגומנטים של מפתח וערך, ואז על ידי קריאה ל-style().set() עם ארגומנט של מילון. הקריאה השנייה לא מבטלת את הראשונה, אלא מוסיפה ומחליפה מאפייני סגנון נפרד במקום להחליף את כל מילון הסגנונות.
למידע נוסף על אפשרויות העיצוב של ווידג'טים, עיינו במסמכי העזר של גיליונות סגנון מדורגים (CSS) לסגנונות שמפורטים במסמכי התיעוד של style() לכל ווידג'ט. חשוב לשים לב שהסגנונות שאפשר להשתמש בהם בווידג'טים של Earth Engine שונים מסגנונות CSS בכמה מקומות, בעיקר fontSize ו-fontWeight עבור font-style ו-font-weight, בהתאמה.
מילון הסגנונות מכיל גם מפתחות ששולטים במיקום של הווידג'ט. בדף Panels and Layouts מוסבר איך להשתמש במאפייני מיקום.