מבוא
אפליקציות Earth Engine הן ממשקי משתמש דינמיים שניתן לשתף, והן מיועדות לניתוחים ב-Earth Engine. באמצעות אפליקציות, מומחים יכולים להשתמש ברכיבים פשוטים בממשק המשתמש כדי לנצל את קטלוג הנתונים ואת יכולות הניתוח של Earth Engine, כך שגם מומחים וגם משתמשים שאינם מומחים יוכלו להשתמש בהם.
אפשר לגשת לאפליקציות שפורסמו מ-Earth Engine דרך כתובת ה-URL הספציפית לאפליקציה שנוצרה בזמן הפרסום. לא צריך חשבון Earth Engine כדי לצפות באפליקציה שפורסמה או להשתמש בה. אפליקציות שהיוצרים שלהן בחרו להציג אותן זמינות גם בגלריית האפליקציות הספציפית למשתמש (למשל, USERNAME.users.earthengine.app).
יצירת האפליקציה
אפליקציות Earth Engine יכולות להשתמש ברוב הפונקציות שמשמשות את עורך הקוד, עם כמה חריגים. בנוסף, עיצבנו את ממשק המשתמש של ה-API במיוחד בשביל מפתחי אפליקציות. אם אתם משתמשים חדשים ב-User Interface API, כדאי לעיין בסקירה הכללית של UI API.
פרסום האפליקציה
כדי לפרסם אפליקציה מעורך הקוד, קודם צריך לטעון את הסקריפט שרוצים להפוך לאפליקציה, ואז לפתוח את חלונית ניהול האפליקציות. אפשר לגשת אליה בלחיצה על הכפתור אפליקציות מעל קטע הסקריפט בעורך הקוד.
לאחר מכן לוחצים על הלחצן NEW APP (אפליקציה חדשה).
בתיבת הדו-שיח, בוחרים את גישת העריכה, שם האפליקציה, פרויקט בענן ב-Google Cloud ואת המיקום של קוד המקור של האפליקציה. אפשר להגביל את הגישה לאפליקציה הזו לקבוצה מסוימת ב-Google או להשאיר אותה נגישה לכולם באמצעות האפשרויות בכרטיסייה "הגבלה". באפליקציות שנגישות לכולם, אפשר גם להוסיף תמונה מותאמת אישית לתצוגה מקדימה של האפליקציה, וגם תיאור בכרטיסייה "גלריה". כדי שהאפליקציה תופיע בגלריית האפליקציות הציבורית שלך בכתובת USERNAME.users.earthengine.app, צריך ללחוץ על "הצגת האפליקציה הזו בגלריית האפליקציות". אפשר להוסיף לוגו מותאם אישית בפינה הימנית העליונה של האפליקציה. כדי לעשות את זה, מעלים תמונה לבחירתכם מהכרטיסייה "לוגו".
ניהול האפליקציות שלכם
כדי לנהל אפליקציה מעורך הקוד, פותחים את החלונית לניהול אפליקציות בלחיצה על הכפתור Apps (אפליקציות) מעל קטע הסקריפט בעורך הקוד. מכאן אפשר לעדכן את ההגדרות של האפליקציה או למחוק אותה.
שיתוף פעולה עם אחרים באפליקציות בבעלות הפרויקט
כברירת מחדל, רק אתם יכולים לערוך אפליקציות שאתם מפרסמים תחת שם המשתמש שלכם. אפשר לעבוד ביחד על אפליקציות באמצעות אפליקציות בבעלות הפרויקט. אפליקציות בבעלות פרויקט הן אפליקציות שנמצאות בבעלות של פרויקט ב-Cloud ומתפרסמות במסגרתו. כל מי שיש לו את התפקיד מפרסם אפליקציות של Earth Engine ב-IAM יכול לערוך ולמחוק אפליקציות שפורסמו במסגרת הפרויקט ב-Cloud. מידע נוסף על תפקידי IAM ב-Earth Engine
כדי להפעיל אפליקציות בבעלות פרויקט, בוחרים באפשרות פרויקט ב-Cloud בשלב "בחירת הרשאת עריכה", בוחרים את הפרויקט ב-Cloud שבו רוצים להשתמש ומסיימים את תהליך פרסום האפליקציה כרגיל. האפליקציה תפורסם בדומיין PROJECT-ID.projects.earthengine.app וכל מי שיש לו את תפקיד ה-IAM "מפרסם אפליקציות של Earth Engine" בפרויקט ב-Cloud יוכל לערוך אותה.
כדי לראות את האפליקציות של פרויקט בענן, לוחצים על הכפתור ADD CLOUD PROJECT ובוחרים את הפרויקט בענן.
כדי לשתף את הפרויקט בענן עם אחרים, לוחצים על הכפתור שיתוף הפרויקט. הפעולה הזו תעביר אתכם לדף IAM במסוף Cloud של הפרויקט, שבו תוכלו להעניק לשותפי העריכה את תפקיד ה-IAM "מפרסם אפליקציות של Earth Engine".
שאלות נפוצות
- איך מסירים אפליקציה מגלריית האפליקציות?
- תיבת הסימון "הצגת האפליקציה הזו" בדף הגדרות האפליקציה קובעת אם האפליקציה תופיע בדף "אפליקציות נבחרות". אי אפשר להציג אפליקציות עם גישה מוגבלת.
- האם קוד Earth Engine שלי גלוי?
- כן, לכל מי שיש לו גישה לאפליקציה. למרות שהקוד לא גלוי באופן ברור כשהאפליקציה מתפרסמת, קל יחסית לראות את קוד ה-JavaScript של האפליקציה על ידי צפייה בתנועה ברשת לדפדפן האינטרנט. לדוגמה, ב-Chrome, אפשר לראות את ה-JavaScript ב חלונית "רשת" של הכלים למפתחים.
- מהן כמה מהסיבות האפשריות לשגיאה "אירעה שגיאה בטעינת חלקים מסוימים במפה" באפליקציה שפורסמה?
- צריך לוודא שכל נכסי התמונות או הטבלאות שמשמשים באפליקציה משותפים באופן ציבורי או עם האפליקציה. בתיבת הדו-שיח לשיתוף נכסים, בוחרים באפשרות "כל אחד יכול לקרוא" או בוחרים את שם האפליקציה מהרשימה הנפתחת. באפליקציות שמוגבלות לקבוצה ב-Google, שיתוף נכס עם אותה קבוצה ב-Google לא יאפשר לאפליקציה להציג אותו. במקום זאת, צריך לשתף את הנכסים עם האפליקציה או באופן ציבורי.
- למה מוצג הדף "האפליקציה עדיין לא מוכנה"?
- אחרי שיוצרים אפליקציה, יכול להיות שיעבור קצת זמן עד שהמידע יתעדכן במערכת. בדרך כלל הבעיה נפתרת תוך כמה דקות. אם השגיאה נמשכת, אפשר לפנות לקבלת עזרה.
- למה הגיאומטריות שציירתי מוצגות באפליקציה שלי?
- כך קל להציג גיאומטריות של קובצי עזר באפליקציה, וליצור אפליקציות שבהן המשתמשים יכולים לערוך את הגיאומטריות. אם אתם לא רוצים שצורות גיאומטריות מסוימות יוצגו או ייערכו, אתם יכולים להסתיר או לנעול שכבות גיאומטריות ספציפיות כדי למנוע ממשתמשים לראות או לערוך אותן לפני פרסום האפליקציה. מידע נוסף זמין ב מסמכי התיעוד של כלי הגיאומטריה.
- מהי מכסת האפליקציה?
- כדי למנוע מסקריפטים שגויים או עתירי משאבים להשפיע לרעה על הזמינות של השירות, ל-Earth Engine יש מכסות שימוש באפליקציה לשאילתות בו-זמניות. המכסה הזו פועלת באופן דומה ל מכסה לכל משתמש ב-Earth Engine, אבל היא מקושרת לאפליקציה ולא למשתמש ספציפי.
- האם לכל אפליקציה שאני יוצר יש מכסה משלה?
- כן, לכל אפליקציה משויכת מכסה נפרדת. באפליקציות ישנות יותר שנוצרו באמצעות מפתח API, המכסה קשורה לפרויקט בענן שממנו נוצר מפתח ה-API של האפליקציה. אם יוצרים כמה מפתחות API מאותו פרויקט בענן, כולם חולקים את אותה מכסת שימוש.
- למה צריך חשבון לחיוב ב-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, במקום לחשב אותם בזמן אמת.