Cloud Assets

נכסי Earth Engine (למשל תמונות, טבלאות) יכולים להיות נכסים מדור קודם (כלומר, לא משויכים לפרויקט בענן) או נכסים שמשויכים לפרויקט ב-Google Cloud. במדריך הזה מוסבר איך להשתמש ב-Asset Manager כדי להעלות נכסים שמשויכים לפרויקט בענן או להשתמש בהם.

Cloud Asset Manager

ב-Cloud Asset Manager יש את הקטע Cloud Assets, את הקטע Legacy Assets ואת הכפתור Add A Project.

Cloud Asset Manager
איור 1. מנהל נכסי הענן של עורך הקוד של Earth Engine.

נכסים בענן

הקטע "נכסים בענן" מכיל נכסים ששייכים לפרויקטים בענן שמוצמדים למנהל הנכסים. כברירת מחדל, פרויקט בענן שנבחר לסשן של Code Editor (כפי שמצוין בפינה הימנית העליונה של Code Editor) מופיע כאן. כדי להצמיד פרויקטים נוספים, לוחצים על Add A Project ובוחרים פרויקט בתיבת הדו-שיח Select a Cloud Project. הנכסים בפרויקטים האלה יוצגו בתיקייה שמוצגת במצב פתוח, והתיקיות המשניות יוצגו במצב סגור.

נכסים קודמים

נכסים מדור קודם הם נכסים שמשויכים לחשבון Earth Engine לפני השילוב של Earth Engine ב-Cloud.

הוספת פרויקט

לוחצים על הכפתור Add a Project כדי לפתוח את תיבת הדו-שיח Select a Cloud Project.

תיבת הדו-שיח Select a Project
איור 2. תיבת הדו-שיח 'בחירת פרויקט בענן'.

בתיבת הדו-שיח הזו יוצג תפריט נפתח לבחירת פרויקט בענן, ויוצגו נכסי Earth Engine שקיימים בפרויקט הזה. פרויקטים שהצמדתם בעבר מוצגים בתור Earth Engine Enabled Projects. כדי להצמיד פרויקט בענן לקטע Cloud Assets ולהציג את הנכסים שכלולים בו, בוחרים פרויקט בענן בתפריט הנפתח ולוחצים על Select.

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

העלאת נכסים

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

ניהול נכסים

אפשר לנהל נכסים דרך הכרטיסייה Asset Manager ב-Code Editor, דרך שורת הפקודה, דרך ספריית לקוח (לדוגמה, ee.data.getAsset) או ישירות דרך ה-API בארכיטקטורת REST.

ניהול הרשאות גישה לנכסים

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

גישה לנכסים

נתיבי הנכסים הם בפורמט projects/${PROJECT_NAME}/assets/${ASSET_NAME}. הנתיבים האלה משמשים בבנאים של ספריות לקוח, כשמבצעים ייצוא דרך אחת מספריות הלקוח, בזמן ההטמעה או ההעלאה ובקריאות ל-API בארכיטקטורת REST.

נכסים ציבוריים

אפשר לגשת לתמונות בקטלוג הציבורי מנתיבים כמו projects/earthengine-public/assets/path/to/asset/asset-id. לדוגמה, סצנה של Landsat:

projects/earthengine-public/assets/LANDSAT/LC08/C02/T1_RT/LC08_001004_20140609

שימו לב שבדוגמה הזו, PROJECT_NAME הוא earthengine-public. אפשר להעביר את הנתיבים האלה ישירות ל-constructors כמו Image, ImageCollection או FeatureCollection. אתם גם מעבירים נתיבי נכסים ל-API בארכיטקטורת REST. כאן יש דוגמה פשוטה מאוד מהמדריך למתחילים בנושא REST.

נכסים אישיים

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

projects/my-ee-enabled-project-id/assets/my-asset-id

בדוגמה הזו, my-ee-enabled-project-id הוא שם הפרויקט שדרכו העלו או יצרו נכסים בעבר. בדף פרויקטים מוסבר איך להפעיל את Earth Engine API בפרויקט ב-Cloud.

נכסים קודמים

נכסים מדור קודם הם נכסים שמאוחסנים בתיקיות users/ או projects/ מדור קודם. כשניגשים לנכסים האלה, הערך של PROJECT_NAME הוא earthengine-legacy. לדוגמה:

projects/earthengine-legacy/assets/users/user-name/my-asset-id

גישה לתמונות ב-Cloud Storage

אתם יכולים לגשת לקובצי Cloud Optimized GeoTIFF‏ (COG) ישירות מקטגוריה של Cloud Storage באמצעות ee.Image.loadGeoTIFF(). אפשר גם ליצור נכסי Earth Engine שמגובים ב-COG, כמו שמתואר במדריך לרישום COG. סקירה כללית זמינה במאמר קובצי COG ב-Earth Engine.