מבוא
אפליקציות של Earth Engine הן ממשקי משתמש דינמיים שניתן לשתף, שמשמשים לניתוח ב-Earth Engine. האפליקציות מאפשרות למומחים להשתמש ברכי��י ��משק משתמש ��ש��טים כדי לנצל את קטלוג הנתונים ואת יכולות הניתוח של Earth Engine, גם למומחים וגם לאנשים רגילים.
אפשר לגשת לאפליקציות שפורסמו מ-Earth Engine דרך כתובת ה-URL הספציפית לאפליקציה שנוצרה בזמן הפרסום. לא נדרש חשבון Earth Engine כדי להציג אפליקציה שפורסמה או לבצע בה פעולות. אפליקציות שנבחרו להצגה על ידי היוצרים שלהן זמינות גם בגלריה של אפליקציות ספציפית למשתמש (למשל, USERNAME.users.earthengine.app).
פיתוח האפליקציה
באפליקציות של Earth Engine אפשר להשתמש ברוב הפונקציות שבהן משתמשים בכלי לעריכת קוד, למעט כמה חריגים. בנוסף, תכננו את ממשק ה-API של ממשק המשתמש תוך התמקדות במפתחי אפליקציות. אם אתם משתמשים חדשים ב-User Interface API, כדאי לעיין ב סקירה הכללית על User Interface API.
פרסום האפליקציה
כדי לפרסם אפליקציה מתוך Code Editor, קודם צריך לטעון את התסריט שרוצים להפוך לאפליקציה, ואז לפתוח את החלונית 'ניהול אפליקציות'. כדי לגשת לחלונית הזו, לוחצים על הלחצן אפליקציות שמעל הקטע של התסריט ב-Code Editor.
לאחר מכן לוחצים על הלחצן אפליקציה חדשה.
בתיבת הדו-שיח, בוחרים את הרשאת העריכה, שם האפליקציה, פרויקט ב-Google Cloud ומציינים את המיקום של קוד המקור של האפליקציה. להגביל את הגישה לאפליקציה הזו לקבוצת Google מסוימת או להשאיר אותה גלויה לכולם באמצעות האפשרויות בכרטיסייה 'הגבלות'. באפליקציות שגלויות לכולם, אפשר גם לספק תמונה מותאמת אישית של תצוגה מקדימה של האפליקציה וגם תיאור בכרטיסייה 'גלריה'. אם רוצים שהאפליקציה תופיע בגלריית האפליקציות הציבורית שלכם בכתובת USERNAME.users.earthengine.app, לוחצים על 'הצגת האפליקציה הזו בגלריית האפליקציות'. אפשר להוסיף לוגו מותאם אישית בפינה הימנית העליונה של האפליקציה על ידי העלאת תמונה לבחירתכם בכרטיסייה 'לוגו'.
ניהול האפליקציות
כדי לנהל אפליקציה מעורך הקוד, לוחצים על הלחצן Apps (אפליקציות) שמעל לקטע של הסקריפט בעורך הקוד, כדי לפתוח את החלונית App Management (ניהול אפליקציות). מכאן אפשר לעדכן את ההגדרות של האפליקציה או למחוק אותה.
שיתוף פעולה עם אחרים באפליקציות בבעלות הפרויקט
כברירת מחדל, רק אתם יכולים לערוך אפליקציות שאתם מפרסמים בשם המשתמש שלכם. אפשר לשתף פעולה באפליקציות באמצעות אפליקציות בבעלות הפרויקט. אפליקציות בבעלות הפרויקט הן אפליקציות שבבעלותכם ופורסמו בפרויקט ב-Cloud. כל משתמש עם תפקיד IAM מסוג Earth Engine Apps Publisher יכול לערוך ולמחוק אפליקציות שפורסמו בפרויקט ב-Cloud. מידע נוסף על תפקידי IAM ב-Earth Engine
כדי להפעיל אפליקציות בבעלות הפרויקט, בוחרים באפשרות Cloud Project בשלב 'בחירת הרשאת עריכה', בוחרים את פרויקט Cloud שבו רוצים להשתמש ומסיימים את תהליך פרסום האפליקציה כרגיל. האפליקציה תפורסם בדומיין PROJECT-ID.projects.earthengine.app וכל מי שיש לו את תפקיד ה-IAM 'בעל אפליקציות של Earth Engine' בפרויקט ב-Cloud יוכל לערוך אותה.
כדי להציג את האפליקציות של פרויקט ב-Cloud, לוחצים על הלחצן ADD CLOUD PROJECT ובוחרים את פרויקט ה-Cloud.
כדי לשתף את הפרויקט ב-Cloud עם אחרים, לוחצים על הלחצן שיתוף הפרויקט. תועברו לדף IAM של הפרויקט במסוף Cloud, שבו תוכלו להקצות לשותפי העריכה את התפקיד 'בעל אפליקציה ב-Earth Engine' ב-IAM.
שאלות נפוצות
- איך מסירים אפליקציה מ'גלריית האפליקציות'?
- תיבת הסימון 'הצגת האפליקציה הזו' בדף ההגדרות של האפליקציה קובעת אם האפליקציה תופיע בדף 'אפליקציות נבחרות'. אי אפשר להציג אפליקציות עם גישה מוגבלת.
- האם הקוד שלי ב-Earth Engine גלוי?
- כל מי שיש לו גישה לאפליקציה יכול לראות את הקוד. הוא לא גלוי בבירור כשהאפליקציה מתפרסמת, אבל קל למדי לראות את ה-JavaScript של האפליקציה על ידי מעקב אחר תעבורת הנתונים ברשת בדפדפן האינטרנט. לדוגמה, ב-Chrome, ה-JavaScript יופיע ב חלונית הרשת בכלים למפתחים.
- מהן כמה מהסיבות האפשריות לשגיאה 'אירעה שגיאה בטעינה של חלקים מהמפה' באפליקציה שפורסמה?
- מוודאים שכל נכסי התמונות או הטבלאות שבהם אתם משתמשים באפליקציה משותפים באופן ציבורי או עם האפליקציה. בתיבת הדו-שיח לשיתוף נכסים, בוחרים באפשרות 'כל אחד יכול לקרוא' או בוחרים את שם האפליקציה מהתפריט הנפתח. באפליקציות שמוגבלות לקבוצת Google, שיתוף נכס עם קבוצת Google הזו לא יאפשר לאפליקציה לראות אותו. במקום זאת, צריך לשתף את הנכסים עם האפליקציה או באופן ציבורי.
- למה מוצגת הדף 'האפליקציה עדיין לא מוכנה'?
- אחרי שיוצרים אפליקציה, יכול להיות שיחלוף זמן מה עד שהמידע ��ופץ במערכת. בדרך כלל הבעיה נפתרת תוך כמה דקות. אם השגיאה נמשכת, אפשר לפנות אלינו לקבלת עזרה.
- למה הגיאומטריות שציירתי מוצגות באפליקציה שלי?
- כך קל להציג גיאומטריות של עזר באפליקציה, וניתן ליצור אפליקציות שבהן המשתמשים יכולים לערוך את הגיאומטריות. אם אתם לא רוצים שגיאומטריות מסוימות יוצגו או ייערכו, תוכלו להסתיר או לנעול שכבות גיאומטריה ספציפיות כדי למנוע מהמשתמשים לראות או לערוך אותן לפני פרסום האפליקציה. למידע נוסף, קראו את המסמכים של כלי הגיאומטריה.
- מהי מכסת אפליקציות?
- כדי למנוע מסקריפטים שגויים או מסקריפטים שצורכים הרבה משאבים להשפיע לרעה על הזמינות של השירות, ב-Earth Engine יש מכסות לשימוש באפליקציות בשאילתות בו-זמניות. המכסה הזו פועלת באופן דומה ל מכסה ��כל ��שתמש ב-Earth Engine, מלבד העובדה שהמכסה קשורה לאפליקציה ולא למשתמש ספציפי.
- האם לכל אפליקציה שאני יוצר יש מכסה משלה?
- כן, לכל אפליקציה משויכת מכסה נפרדת. באפליקציות ישנות יותר שנוצרו באמצעות מפתח API, המכסה קשורה לפרויקט ב-Cloud שממנו יצרתם את מפתח ה-API של האפליקציה. אם יוצרים כמה מפתחות API מאותו פרויקט ב-Cloud, כולם ישתפו את אותה מכסת שימוש.
- למה נדרש חשבון לחיוב ב-Cloud? האם אחויב על האפליקציות שלי?
- אנחנו משתמשים ב-Google Cloud Platform למגוון משימות מאחורי הקלעים. לא תחויבו על יצירת אפליקציה של Earth Engine. עם זאת, Google Cloud Storage הוא לא שירות בחינם, כך שאם תבחרו לייצא את תוצאות הניתוחים שלכם ל-Google Cloud Storage, יכול להיות שתצטרכו לשלם עמלה.
- איך אפשר להבין טוב יותר את השימוש באפליקציות ואת המכסות שלהן?
-
אם חורגים מהמכסה, יכול להיות ש-Earth Engine יחזיר שגיאות מסוג
HTTP 429: Too Many Requests. בדרך כלל, ספריית הלקוח של Earth Engine מטפלת בשגיאות האלה, ומבצעת השהיה מעריכית לפני ניסיון חוזר (exponential backoff) של הבקשות, עד שהשאילתה תתבצע בהצלחה. ספריית הלקוח של Earth Engine תנסה שוב לשלוח את הבקשה חמש פעמים.אם האפליקציה שלכם תהיה פופולרית כל כך שמשתמשים רבים יקבלו שגיאות מסוג 'חריגה מהמכסה', המשתמשים יראו הודעת אזהרה ויכול להיות ש-Earth Engine יצטרך להגביל (באופן זמני) את הגישה לאפליקציה.
כדי להימנע מקבלת שגיאות 429, מומלץ להפעיל אחסון במטמון באפליקציה, למשל על ידי אחסון נתונים סטטיסטיים מצטברים שניתנים לאחסון במטמון כנכסי טבלה של Earth Engine, במקום לחשב אותם בזמן אמת.