עורך הקוד של Earth Engine

עורך הקוד (EE) של Earth Engine בכתובת code.earthengine.google.com הוא סביבת פיתוח משולבת (IDE) מבוססת-אינטרנט ל-Earth Engine JavaScript API. התכונות של Code Editor נועדו להפוך את הפיתוח של תהליכי עבודה גיאו-מרחביים מורכבים למהיר וקל. עורך הקוד כולל את הרכיבים הבאים (כפי שמוצג באיור 1):

  • עורך קוד JavaScript
  • תצוגת מפה להמחשה של מערכי נתונים גיאו-מרחביים
  • מאמרי העזרה של ה-API (הכרטיסייה Docs)
  • מנהל סקריפטים מבוסס Git (הכרטיסייה Scripts)
  • פלט המסוף (הכרטיסייה 'מסוף')
  • מנהל המשימות (הכרטיסייה 'משימות') לטיפול בשאילתות לטווח ארוך
  • שאילתה לגבי מפה אינטראקטיבית (הכרטיסייה 'כלי הבדיקה')
  • חיפוש בארכיון הנתונים או בסקריפטים שמורים
  • כלי שרטוט גיאומטרי

הרכיבים של עורך הקוד

איור 1. דיאגרמה של רכיבים של Earth Engine Code Editor בכתובת code.earthengine.google.com.

בעורך הקוד יש מגוון תכונות שיעזרו לכם להפיק את המרב מ-Earth Engine API. בכרטיסייה Scripts אפשר לראות סקריפטים לדוגמה או לשמור סקריפטים משלכם. אפשר להציב אובייקטים של שאילתות במפה באמצעות הכרטיסייה Inspector. הצגה של תוצאות מספריות בתרשים באמצעות Google Visualization API. כדי לשתף כתובת URL ייחודית לסקריפט עם שותפי עריכה וחברים, לוחצים על הלחצן קבלת קישור. סקריפטים שאתם מפתחים בכלי לעריכת קוד נשלחים אל Google לצורך עיבוד, ואריחי המפה או ההודעות שנוצרו נשלחים בחזרה להצגה בכרטיסייה Map (מפה) או בכרטיסייה Console (מסוף). כל מה שצריך כדי להריץ את Code Editor הוא דפדפן אינטרנט (מומלץ להשתמש ב-Google Chrome לקבלת התוצאות הטובות ביותר) וחיבור לאינטרנט. בקטעים הבאים מפורטים רכיבים של כלי העריכה של הקוד ב-Earth Engine.

עורך JavaScript

הכלי לעריכת JavaScript:

  • עיצוב והדגשה של קוד תוך כדי הקלדה
  • הדגשת קוד עם בעיות, הצעת תיקונים ורמזים אחרים לתחביר נכון
  • השלמה אוטומטית של זוגות של מירכאות, סוגריים מרובעים וסוגריים עגולים
  • הצעת רמזים להשלמת קוד לפונקציות של Earth Engine

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

הפניית API (הכרטיסייה Docs)

בצד ימין של הכלי לעריכת קוד נמצאת הכרטיסייה Docs (מסמכים), שכוללת את כל המסמכים של JavaScript API. אפשר לחפש ולעיין בתיעוד בכרטיסייה Docs.

מנהל הסקריפטים (הכרטיסייה 'סקריפטים')

הכרטיסייה Scripts (סקריפטים) נמצאת לצד API Docs (מסמכי API) בחלונית הימנית של Code Editor (עורך הקוד). ב-Script Manager מאוחסנים סקריפטים פרטיים, סקריפטים משותפים וסקריפטים לדוגמה במאגרי Git שמתארחים ב-Google. המאגרים מסודרים לפי רמת הגישה, והסקריפטים הפרטיים שלכם מאוחסנים במאגר שבבעלותכם בתיקייה Owner‏: users/username/default. לכם (ורק לכם) יש גישה למאגרי המידע בתיקייה בעלים, אלא אם אתם משתפים אותם עם מישהו אחר. המאגרים בתיקייה Writer הם מאגרים שהבעלים שלהם העניקו לכם הרשאת כתיבה. אתם יכולים להוסיף סקריפטים חדשים למאגרים בתיקייה Writer, לשנות סקריפטים קיימים או לשנות את הגישה אליהם (אבל לא להסיר את הבעלים שלהם). המאגרים בתיקייה Reader הם מאגרים שהבעלים שלהם העניקו לכם גישת קריאה. התיקייה Examples היא מאגר מיוחד שמנוהל על ידי Google ומכיל דוגמאות קוד. התיקייה Archive מכילה מאגרי מידע מדור קודם שיש לכם גישה אליהם, אבל הבעלים שלהם עדיין לא העבירו אותם מגרסה ישנה יותר של Script Manager. מחפשים בסקריפטים באמצעות סרגל המסננים בחלק העליון של הכרטיסייה סקריפטים.

מנהל הסקריפטים

איור 2. מנהל הסקריפטים.

לוחצים על הלחצן כדי ליצור מאגר חדש בתיקייה Owner או כדי ליצור תיקיות וקבצים במאגר. אפשר לשנות את השם של סקריפטים באמצעות הסמל ולמחוק אותם באמצעות הסמל . אפשר להעביר סקריפטים ולארגן אותם בתיקיות באמצעות גרירה ושחרור (איור 2). אם גוררים סקריפט למאגר אחר, הוא מועתק.

כל הסקריפטים והמאגרים שומרים היסטוריית גרסאות מלאה. לוחצים על הסמל לצד סקריפט או מאגר כדי להשוות אותו לגרסה קודמת או כדי לחזור לגרסה קודמת. כדי למחוק מאגר, לוחצים על הסמל . כדי להגדיר גישה למאגר, לוחצים על הסמל לצד שם המאגר. שימו לב: אם אתם משתפים מאגר, האדם שאיתו אתם משתפים יצטרך לאשר את השיתוף של המאגר על ידי לחיצה על הקישור שמוצג בתיבת הדו-שיח של ההגדרות. אפשר להסתיר מאגרים שאושרו בעבר על ידי לחיצה על הסמל אחרי שם המאגר בכלי לניהול סקריפטים.

אפשר לגשת למאגרים באמצעות Git, כך שאפשר לנהל ולערוך את הסקריפטים מחוץ לכלי לעריכת קוד, או לסנכרן אותם עם מערכת חיצונית כמו GitHub. (מידע נוסף על Git זמין במדריך הזה). לוחצים על הסמל לצד שם המאגר כדי לקבל הוראות לשכפול המאגר. שימו לב: אפשר לעיין במאגרי המידע שיש לכם גישה אליהם בכתובת earthengine.googlesource.com. כדי לבצע פעולות מסוימות ב-Git, יכול להיות שתצטרכו ליצור פרטי אימות. לשם כך, צריך ללחוץ על הקישור 'יצירת סיסמה' בחלק העליון של הדף earthengine.googlesource.com.

מודולים של סקריפטים

מומלץ לכתוב קוד מודולרי לשימוש חוזר שאפשר לשתף בין סקריפטים בלי להעתיק ולהדביק אותו שוב ושוב. כדי לאפשר פיתוח מודולרי,‏ Earth Engine מספק אפשרות לשתף קוד בין סקריפטים. לדוגמה, נניח שכתבתם פונקציה שמבצעת קבוצה שימושית של פעולות. במקום להעתיק את הקוד של הפונקציה לסקריפט חדש, קל יותר לטעון את הפונקציה ישירות לסקריפט החדש. כדי להפוך פונקציה או אובייקט לזמינים לסקריפטים אחרים, מוסיפים אותם לאובייקט מיוחד שנקרא exports. כדי להשתמש בקוד בסקריפט אחר, צריך להשתמש בפונקציה require כדי לטעון את הפונקציות המיוצאות מסקריפט אחר. לדוגמה, נניח שהגדרתם את המודול הבא בקובץ בשם FooModule.js שנמצא בתיקייה בשם Modules:

Code Editor (JavaScript)

/**
 * 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. לדוגמה:

Code Editor (JavaScript)

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'. אפשר לטעון מודולים רק ממאגרים שבבעלותכם או שיש לכם גישת קריאה אליהם. אם רוצים שאנשים אחרים יוכלו להשתמש במודול, צריך לשתף את המאגר עם המשתמשים שרוצים לתת להם גישה. מומלץ לתעד את המודול כדי לעזור לאחרים להבין איך להשתמש בו. מומלץ להשתמש בסגנון JSDoc עם התג @module.

אפשר להשתמש בפרמטר ?scriptPath={repo}:{script} של כתובת ה-URL כדי לשתף הפניה לקובץ במאגר, למשל https://code.earthengine.google.com/?scriptPath=users/username/utils:utils. כשנכנסים לכתובת ה-URL, הקובץ שאליו מתייחסים ומאגר הקבצים שלו יתווספו לספריית Reader או לספריית Writer בכרטיסייה Scripts, בהתאם לרמת ההרשאה שלכם למאגר הקבצים המשותף.

מנהל הנכסים (הכרטיסייה 'נכסים')

הכלי לניהול נכסים נמצא בכרטיסייה נכסים בחלונית הימנית. אפשר להשתמש בכלי לניהול נכסים (איור 3) כדי להעלות ולנהל נכסי תמונות משלכם ב-Earth Engine. פרטים נוספים זמינים בדף של המרכז לניהול נכסים.

הכלי לניהול נכסים

איור 3. המרכז לניהול נכסים.

אפשר לשתף סקריפטים של Code Editor באמצעות כתובת URL מקודדת. בקטעים הבאים מתוארות דרכים שונות ליצירת כתובת URL של סקריפט, האפשרויות הזמינות ושיטות לניהול כתובות URL של סקריפטים.

הלחצן 'קבלת קישור' בחלק העליון של עורך הקוד (איור 4) מספק ממשק ליצירת כתובות URL של סקריפטים ולהגדרת אפשרויות התנהגות של סקריפטים. חשוב לשים לב להבדלים בין כתובות URL של תמונת מצב לבין כתובות URL של סקריפט שנשמר, שמתוארים בהמשך.

בדף

איור 4. הלחצן 'קבלת קישור'.

אפשר לשתף קוד בעורך באמצעות כתובת URL מקודדת של תמונת מצב שנוצרת כשלוחצים על הלחצן 'קבלת קישור' בחלק העליון של עורך הקוד. כשמשתמש עם חשבון Earth Engine נכנס לכתובת ה-URL, הדפדפן עובר אל Code Editor ומשכפל את הסביבה כפי שהייתה כשנוצר הקישור, כולל קוד, ייבוא, שכבות מפה ומיקום המפה. כשלוחצים על הלחצן 'קבלת קישור', הקישור לסקריפט מועתק אוטומטית ללוח. בנוסף, תופיע תיבת דו-שיח עם אפשרויות לשליטה בהרצת הסקריפט המשותף, וגם כפתורים להעתקה ולמעבר לקישור שנוצר. אפשרויות השליטה כוללות מניעת הפעלה אוטומטית של הסקריפט והסתרת חלונית הקוד כשמישהו פותח את הקישור המשותף. אפשר לסגור את תיבת הדו-שיח שניתן לגרור אותה באמצעות המקש Esc או לחיצה במקום אחר בדף.

בסקריפטים שמורים יש אפשרות לשתף קישור שתמיד יטען את הגרסה השמורה האחרונה, ורק לכם ולאנשים אחרים שיש להם גישה נוכחית למאגר שמכיל את הסקריפט תהיה גישה לקישור. כדי להשתמש בתכונה הזו, טוענים סקריפט שמור מהכרטיסייה Script Manager (ניהול סקריפטים), לוחצים על החץ לתפריט הנפתח משמאל ללחצן Get Link (קבלת קישור) ובוחרים באפשרות Copy Script Path (העתקת נתיב הסקריפט). תופיע תיבת דו-שיח עם כתובת ה-URL של הסקריפט שאפשר לשתף. שימו לב שכתובת ה-URL של הסקריפט מוגדרת גם בסרגל הכתובות של הדפדפן. הנחיות לשיתוף המאגר עם אחרים מופיעות בקטע בנושא Script Manager.

לחצן התפריט הנפתח משמאל ללחצן 'קבלת קישור' כולל את האפשרות 'ניהול קישורים'. אם לוחצים על האפשרות הזו, נפתחת כרטיסייה חדשה בדפדפן עם ממשק שמאפשר לכם לאחזר, להסיר ולהוריד קישורים לסקריפטים שנוצרו בעבר. אם בוחרים סקריפט ולוחצים על לחצן ההורדה, המערכת תוריד למחשב תיקייה דחוסה (code_editor_links.zip) שמכילה קובץ txt לכל סקריפט שנבחר.

מודול ui.url מאפשר לבצע מניפולציה פרוגרמטית של מזהה הפרגמנט של כתובת ה-URL של הסקריפט באמצעות שיטות get ו-set. זה אומר שסקריפטים של Code Editor ואפליקציות של Earth Engine יכולים לקרוא ולאחסן ערכים בכתובת ה-URL של הדף. שימו לב לסוף של שתי כתובות ה-URL הבאות. בראשונה, המשתנה debug מוגדר כ-false, ובשנייה הוא מוגדר כ-true. אם תלחצו על שני הקישורים, תראו שבתיבת הסימון של ניפוי הבאגים במסוף לא מסומנת בקישור הראשון, אבל מסומנת בקישור השני. כך משתנה אופן הפעולה של כל סקריפט.

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

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

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

כלי החיפוש

כדי למצוא מערכי נתונים לשימוש בסקריפטים, אפשר להשתמש בכלי החיפוש של ארכיון הנתונים. כלי החיפוש הוא תיבת הטקסט בחלק העליון של עורך הקוד, שמופיע בה הכיתוב 'חיפוש מקומות ומערכי נתונים...'. מקלידים את השם של מוצר נתונים, חיישן או מילת מפתח אחרת בסרגל החיפוש ולוחצים על הלחצן כדי לראות רשימה של מקומות תואמים, מערכי נתונים של רסטר וטבלה. כדי לראות את התיאור של מערך הנתונים בארכיון, לוחצים על תוצאה של רסטר או טבלה. כדי לייבא את מערך הנתונים ישירות לסקריפט, לוחצים על הקישור import או על הלחצן בתיאור של מערך הנתונים.

יבוא

תוצאות הייבוא של מערכי נתונים לסקריפט מאורגנות בקטע imports בחלק העליון של הסקריפט, והן מוסתרות עד שמייבאים משהו. אחרי שיוצרים כמה ייבואים, אמור להופיע משהו דומה למה שמוצג באיור 5. כדי להעתיק ייבוא לסקריפט אחר או להמיר את הייבוא ל-JavaScript, לוחצים על הסמל לצד הכותרת ייבוא ומעתיקים את הקוד שנוצר לסקריפט. אפשר למחוק את הייבוא באמצעות הסמל .

מקטע הייבוא בעורך הקוד

איור 5. בקטע imports בחלק העליון של עורך הקוד.

מפה

אובייקט המפה ב-API מתייחס לתצוגת המפה בעורך הקוד. לדוגמה, Map.getBounds() תחזיר את האזור הגיאוגרפי שמוצג בכלי לעריכת קוד. כדי לראות התאמות אישיות אחרות של התצוגה הזו, אפשר לעיין בפונקציות Map ב-API.

Layer Manager

כדי לשנות את התצוגה של השכבות שהוספתם למפה, משתמשים בכלי לניהול שכבות בפינה השמאלית העליונה של המפה. באופן ספציפי, אפשר להחליף את מצב החשיפה של שכבה או לשנות את השקיפות שלה באמצעות פס ההזזה. לוחצים על הסמל כדי לשנות את פרמטרים ההדמיה של שכבות ספציפיות. כלי הוויזואליזציה שמופיע (איור 6) מאפשר לכם להגדיר באופן אינטראקטיבי את פרמטרי התצוגה של השכבה. לוחצים על הלחצן שמשמאל לכלי (שמבצע מתיחה מותאמת אישית לטווח המינימלי והמקסימלי שצוין כברירת מחדל) כדי למתוח באופן לינארי את התצוגה לאחוזונים או לסטיית תקן של ערכי התמונה בחלון התצוגה. הנתונים הסטטיסטיים מחושבים מכל הפיקסלים בחלון המפה ברמת הזום הנוכחית. משתמשים בפסי ההזזה כדי לשנות את הגאמה או את השקיפות. לוחצים על לחצן הבחירה Palette ומציינים לוח צבעים בהתאמה אישית על ידי הוספת צבעים (), הסרת צבעים () או הזנה ידנית של רשימה של מחרוזות הקסדצימליות מופרדות בפסיקים (). לוחצים על Apply כדי להחיל את פרמטרי הוויזואליזציה על התצוגה הנוכחית. לוחצים על Import (ייבוא) כדי לטעון אובייקט של פרמטרים של ויזואליזציה כמשתנה חדש בקטע imports (ייבוא) של התסריט.

כלי התצוגה החזותית של השכבה.

איור 6. כלי ההמחשה של השכבה.

הכרטיסייה 'כלי הבדיקה'

בכרטיסייה Inspector שליד Task Manager אפשר להריץ שאילתות אינטראקטיביות במפה. כשמפעילים את הכרטיסייה Inspector, הסמן הופך לכוונת. כשלוחצים על המפה, מוצגים המיקום והערכים של השכבה מתחת לסמן. לדוגמה, באיור 7 מוצגות התוצאות של לחיצה על המפה בכרטיסייה Inspector. מיקום הסמן ורמת הזום מוצגים יחד עם ערכי הפיקסלים ורשימת האובייקטים במפה. רשימת האובייקטים היא אינטראקטיבית. כדי לראות מידע נוסף, מרחיבים את האובייקטים בכרטיסייה Inspector.

הכרטיסייה 'כלי הבדיקה'

איור 7. בכרטיסייה Inspector מוצג מידע על מיקום הסמן ועל ערכי השכבה מתחת לסמן.

כרטיסיית המסוף

כשמריצים print() משהו מהסקריפט, כמו טקסט, אובייקטים או תרשימים, התוצאה מוצגת במסוף. המסוף אינטראקטיבי, כך שאפשר להרחיב אובייקטים מודפסים כדי לקבל עליהם פרטים נוספים.

הכרטיסייה 'משימות'

משימות Earth Engine הן פעולות שיכולות לפעול הרבה יותר זמן מהזמן הקצוב לתפוגה של בקשת API רגילה. המשימות הארוכות האלה הן המנגנון היחיד ליצירת ארטיפקטים קבועים ב-Earth Engine ובמערכות סמוכות (Google Cloud Storage,‏ Google Drive וכו'), והן מחולקות לשתי קטגוריות: Import ו-Export.

אפשר להשתמש במשימות ייבוא כדי להעלות תמונות או להעלות טבלאות ל-Earth Engine ממגוון סוגי קבצים (.csv, .tif וכו'). אפשר להשתמש בפעולות ייצוא כדי להפעיל ולכתוב תוצאות ממערכת החישוב של EE (ראו את המדריך לייצוא נתונים).

בייצוא, כל קריאה לפונקציה Export בכלי לעריכת קוד תאכלס ערך בקטע משימות שלא נשלחו בכרטיסייה משימות. כדי לשלוח משימת ייצוא לשרת, לוחצים על הלחצן הפעלה לצד המשימה. תופיע תיבת דו-שיח של הגדרות שבה תוכלו לציין מגוון פרמטרים למשימה. אם המשימה מוגדרת באופן מלא בזמן היצירה (כלומר, לקריאה אל Export יש את כל הפרמטרים הנדרשים), לוחצים על הפעלה תוך כדי החזקת המקש ctrl או ⌘ כדי לשלוח את המשימה בלי להציג את תיבת הדו-שיח.

בייבוא, העלאת הקובץ מתבצעת באופן מקומי לפני שהמשימה נשלחת לשרת. במהלך ההעלאה, התקדמות הייבוא של המשימות תוצג בקטע משימות שלא נשלחו, והן יישלחו אוטומטית לשרת כשהעלאת הקובץ תסתיים.

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

כדי לראות ולבטל כמה משימות בתצוגה במסך מלא (כולל בלקוחות לנייד), משתמשים בדף המשימות במסוף Cloud.

כלי לניתוח ביצועים (

בכלי ליצירת פרופילים מוצג מידע על המשאבים (זמן מעבד, זיכרון) שנצרכים על ידי אלגוריתמים ספציפיים וחלקים אחרים בחישוב. כך אפשר לאבחן למה סקריפט פועל לאט או נכשל בגלל מגבלות זיכרון. כדי להשתמש בכלי לניתוח ביצועים, לוחצים על האפשרות Run with profiler (הפעלה עם הכלי לניתוח ביצועים) בתפריט הנפתח של לחצן ההפעלה. כקיצור דרך, לוחצים לחיצה ארוכה על Alt (או על Option ב-Mac) ולוחצים על Run (הפעלה), או מקישים על Ctrl+Alt+Enter. פעולה זו מפעילה כרטיסייה של Profiler בצד שמאל של עורך הקוד. במהלך הפעלת הסקריפט, בכרטיסייה Profiler תוצג טבלה של נתוני השימוש במשאבים מתוך הסקריפט. לחיצה על הלחצן Run (בלי פרופיל) תגרום להעלמת הכרטיסייה Profiler ולהשבתת הפרופיל.

בדף computation overview מפורט הפלט של כלי הפרופיל.

עוזר אישי מבוסס-AI (הכרטיסייה 'שאלות')

עורך הקוד כולל עוזר מבוסס-AI, שמבוסס על Gemini, שיעזור לכם לכתוב, לנפות באגים ולהבין את הסקריפטים. העוזר זמין בכרטיסייה Ask בחלונית השמאלית.

לפרטים על הגדרה ושימוש בעוזר, אפשר לעיין במדריך בנושא עוזר מבוסס-AI בכלי לעריכת קוד ב-Earth Engine.

כלים לגיאומטריה

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

שימוש באחד מכלי הציור יוצר באופן אוטומטי שכבת גיאומטריה חדשה ומוסיף ייבוא לשכבה הזו לקטע 'ייבוא'. כדי להוסיף צורות גיאומטריות לשכבה חדשה, מעבירים את העכבר מעל Geometry Imports (ייבוא צורות גיאומטריות) בתצוגת המפה ולוחצים על הקישור +new layer (שכבה חדשה). אפשר גם להחליף את מצב החשיפה של הצורות הגיאומטריות בקטע Geometry Imports (ייבוא צורות גיאומטריות). שימו לב: כברירת מחדל, צורות גיאומטריות ששורטטו הן גיאודזיות, למעט מלבנים שהם מישוריים בלבד. משתמשים בבונה הגיאומטריה כדי להמיר אותם לגיאומטריות מישוריות. מידע נוסף על גיאומטריות ב-Earth Engine זמין בדף בנושא גיאומטריה.

איור 8. הכלים לציור גיאומטריה נמצאים בפינה הימנית העליונה של תצוגת המפה.

כדי להגדיר את אופן הייבוא של גיאומטריות לסקריפט, לוחצים על הסמל לצד השכבה בקטע Geometry Imports (ייבוא גיאומטריות) במפה או בקטע Imports (ייבוא) בכלי לעריכת קוד. כלי ההגדרות של שכבת הגיאומטריה יוצג בתיבת דו-שיח שצריכה להיראות כמו איור 9. שימו לב שאפשר לייבא את הצורות שציירתם כגיאומטריות, כמאפיינים או כאוספים של מאפיינים. בהגדרות הייבוא של הגיאומטריה אפשר גם לשנות את הצבע שבו השכבה מוצגת, להוסיף מאפיינים לשכבה (אם היא מיובאת כ-Feature או כ-FeatureCollection) או לשנות את השם של השכבה.

כלי ההגדרה של הגיאומטריה

איור 9. כלי הגדרת הגיאומטריה.

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

איך אוכל לקבל עזרה?

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