גישה ל-Earth Engine

‫Earth Engine פועל ב-Google Cloud ונדרשים פרויקטים ב-Cloud כדי לגשת אליו ולנהל את ה-API שלו. כל הקריאות ל-Earth Engine (בין אם מ-Code Editor, מספריות לקוח, מאפליקציות או מ-REST API) מנותבות דרך פרויקט ב-Cloud, וכך מתאפשרת ב-Cloud Console בקרת גישה, ניהול משאבים ומעקב אחר השימוש.

קבלת גישה אל Earth Engine

כדי להשתמש ב-Earth Engine, צריך גישה לפרויקט ב-Cloud:

• הפעלתם את Earth Engine API,
• רשום לשימוש מסחרי או לא מסחרי, ו
• להקצות לכם (או למשתמש) את התפקידים וההרשאות הנכונים.

https://code.earthengine.google.com/register?project=my-project

earthengine create folder projects/my-project/assets/

ציון פרויקט

בקטעים הבאים מתואר איך מציינים פרויקט לממשקים השונים של שירותי Earth Engine.

ספריות לקוח (Python, ‏ JavaScript)

הפונקציה ee.Initialize() משמשת לציון פרויקט לבקשות של Earth Engine שמקורן בספריות הלקוח של Python ושל JavaScript. יש כמה דרכים להגדיר את פרטי הפרויקט. פרטים נוספים זמינים בדף אימות ואתחול.

עורך קוד

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

אפליקציות Earth Engine

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

כלי שורת הפקודה

כדי לשייך קריאות ל-Earth Engine מכלי שורת הפקודה לפרויקט ב-Cloud, משתמשים בפרמטר --project בקריאה ל-earthengine או משתמשים ב-set_project כדי להגדיר פרויקט שמשמש כברירת מחדל.

API ל-REST

כדי לשייך קריאות ל-REST API לפרויקט ב-Cloud, צריך להנפיק קריאות HTTP מאומתות שבהן האימות מטופל על ידי oauth2. בסביבה מקומית, אפשר להשתמש בפקודה gcloud. אפשר גם להשתמש בחשבון שירות שמשויך לפרויקט Cloud. במאמר תחילת העבודה עם REST API יש דוגמה לשימוש ב-google.oath.service_account.Credentials.from_service_account_file() לצורך אימות באמצעות חשבון שירות.

הגדרת הגישה לפרויקט

בקטעים הבאים מתואר איך להגדיר פרויקטים עם Earth Engine לשימוש של אנשים אחרים וחשבונות שירות.

חשבונות שירות

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

חשבונות Google

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

מזהה לקוח ב-OAuth 2.0

יכול להיות שתצטרכו ליצור מזהה לקוח ב-OAuth 2.0 מפרויקט, למשל כדי ליצור אפליקציה שמעבירה פרטי כניסה של משתמשים ל-Earth Engine. כדי לנהל את אמצעי האימות של פרויקט Cloud, נכנסים לתפריט מסוף Cloud (menu) ובוחרים באפשרות APIs & Services >‏ Credentials. (בוחרים את הפרויקט אם מתבקשים).

כדי ליצור מזהה לקוח חדש לפרויקט, לוחצים על + CREATE CREDENTIALS (יצירת פרטי כניסה) > OAuth client ID (מזהה לקוח OAuth) > Web application (אפליקציית אינטרנט).

בהגדרות של אפליקציית האינטרנט:

• מציינים מקורות מורשים של JavaScript, לדוגמה:

http://localhost:8080
https://foo-ee-project.appspot.com

• מציינים כתובות URI מורשות להפניה אוטומטית, לדוגמה:

http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

מידע נוסף על אימות משתמשים באמצעות OAuth

תרחישים נפוצים

מחיקת נתונים ב-Earth Engine

מחיקה ברמת החשבון

מחיקה ברמת החשבון תסיר את כל הנתונים של Earth Engine מהחשבון.

אם החשבון שלכם הוא חלק מארגון ב-Google Workspace, האדמין שולט בנתוני החשבון. כשאדמין מוחק חשבון Google, כל הנתונים המשויכים ל-Earth Engine נמחקים תוך כ-30 יום.

צוות Earth Engine לא יכול לשחזר נתונים אחרי שהם נמחקים.

פרויקטים ב-Cloud

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

נכסים

הדרך הכי פשוטה למחוק נכסים היא להשתמש בכרטיסייה Assets (נכסים) בכלי Code Editor כדי להציג ולמחוק ידנית את הנכסים שלכם ב-Earth Engine.

למחיקה פרוגרמטית של נכס עם המזהה projects/{project-id}/assets/{asset-id} (לדוגמה, projects/my-project/assets/my-asset):

ee.data.deleteAsset('projects/my-project/assets/my-asset')

ee.data.deleteAsset('projects/my-project/assets/my-asset')

earthengine rm projects/my-project/assets/my-asset

סקריפטים של עורך הקוד

כדי למחוק את הסקריפטים שלכם ב-Earth Engine Code Editor:

אפליקציות Earth Engine

כדי למחוק אפליקציות של Earth Engine, משתמשים בלחצן Apps בעורך הקוד כדי לנהל את האפליקציות.

הפניות ל'קבלת קישור'

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

הגדרת גישה לא מסחרית

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

אימות

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

החל מ-26 בספטמבר 2025, בכל הפרויקטים הלא מסחריים צריך למלא את השאלון במסוף Cloud. מומלץ להשלים את תהליך האימות בהקדם האפשרי. אם לא תבצעו פעולה לפני 26 בספטמבר 2025, הגישה של הפרויקט שלכם ל-Earth Engine תושהה עד שתשלימו את תהליך האימות.

אימות מחדש

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

הגדרת גישה מסחרית

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

סיום הגישה המסחרית

אם אתם לקוחות ישירים של Earth Engine ורוצים להפסיק להשתמש ב-Earth Engine בהקשר בתשלום, יש לבצע כמה שינויים כדי שלא יחויב יותר תשלום:

• איך מפסיקים את החיובים על מינוי

  • כדי לבטל את המינוי ל-Earth Engine בחשבון לחיוב, צריך להשתמש בדף Manage Plans (ניהול תוכניות). אפשר לגשת לדף הזה מתפריט הנפתח של הגדרות המשתמש בפינה השמאלית העליונה של עורך הקוד, כשמשתמשים בפרויקט רשום ב-Cloud שמקושר לחשבון לחיוב.

  • אפשר גם להיכנס ישירות לדף 'ניהול תוכניות' בחשבון לחיוב:

    https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID
    

  • אם בוחרים בתוכנית 'מוגבלת', לא יחויב יותר חשבון החיוב שלכם בדמי מינוי לפלטפורמת Earth Engine אחרי מחזור החיובים הנוכחי.

• הפסקת חיובים על שימוש במחשוב

  • כדי למנוע חיובים חדשים שקשורים לחישוב (זמן EECU), צריך להשבית את Earth Engine API בפרויקטים שלכם ב-Cloud. שימו לב שהפעולה הזו לא מפסיקה בקשות שנמצאות בתהליך ולא מוחקת אובייקטים מאוחסנים, כך שעדיין יכול להיות שתחויבו על Earth Engine גם אם ה-API מושבת.
  • מידע על השבתה של ממשקי API זמין בעזרה בנושא API Console.

• הפסקת חיובים על אחסון

  • נכסי Earth Engine שמאוחסנים ממשיכים לצבור עלויות גם אם ה-API מושבת. מחיקת הנכסים תמנע חיובים נוספים על אחסון ב-EE.