גישה ל-Earth Engine

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

איך מקבלים גישה ל-Earth Engine

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

יצירת פרויקט

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

אפשר לנהל פרויקטים שנוצרו במהלך תהליך הרישום במסוף Google Cloud. אפשר להפעיל או להשבית את Earth Engine API מדף Earth Engine API במסוף Cloud.

שלבים ידניים (אוטומטיים בדף ההרשמה)

יצירת פרויקט בענן

אם עדיין לא עשיתם את זה, יוצרים פרויקט בענן ב-Google Cloud. אפשר לעשות זאת מדף הפרויקטים במסוף Cloud, או ללחוץ על הלחצן הבא:

יצירת פרויקט בענן

הפעלת Earth Engine API

כדי להפעיל את Earth Engine API בפרויקט, לוחצים על הכפתור הבא כדי לעבור לדף של Earth Engine API:

הפעלת Earth Engine API

בדף Earth Engine API, מוודאים שהפרויקט נבחר ולוחצים על הכפתור ENABLE.

לרשום את הפרויקט לשימוש מסחרי או לא מסחרי

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

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

יצירת תיקיית נכסים (אופציונלי)

אתם יכולים ליצור תיקיית נכסים ב-Earth Engine שמשויכת לפרויקט ב-Cloud שיש לכם גישה אליו, באמצעות הפקודה earthengine create folder עם נתיב כמו שמתואר כאן. לדוגמה:

earthengine create folder projects/my-project/assets/

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

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

שימוש בפרויקט קיים

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

ציון פרויקט

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

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

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

עורך הקוד

לוחצים על סמל הפרופיל בפינה השמאלית העליונה של עורך הקוד ובוחרים באפשרות Change Cloud Project (שינוי פרויקט ב-Cloud) מהתפריט. בוחרים פרויקט מתיבת הדו-שיח.

אפליקציות Earth Engine

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

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

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

‫API בארכיטקטורת REST

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

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

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

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

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

חשבונות Google

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

מזהה לקוח OAuth 2.0

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

כדי ליצור מזהה לקוח חדש לפרויקט, לוחצים על ‎+ CREATE CREDENTIALS‏ > OAuth client ID‏ > 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

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

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

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

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

פרויקטים בענן

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

נכסים

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

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

לקוח Python

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

לקוח JavaScript

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

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

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

משתמשים בפקודה rm:

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

סקריפטים של Code Editor

כדי למחוק את הסקריפטים של עורך הקוד של Earth Engine:

עורך הקוד

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

שימוש ב-Git

משתמשים מתקדמים יכולים להשתמש ב-Git כדי לנהל את הסקריפטים שלהם. בכתובת https://earthengine.googlesource.com/ מופיעה רשימה של המאגרים שאתם יכולים לראות.

אפליקציות 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 (ניהול תוכניות) (אפשר לגשת אליו מהתפריט הנפתח של הגדרות המשתמש בפינה השמאלית העליונה של Code Editor כשמשתמשים בפרויקט בענן רשום שמקושר לחשבון לחיוב).
    • אפשר גם להיכנס ישירות לדף Manage Plans של החשבון לחיוב:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID
      
    • אם תבחרו בתוכנית Limited, החשבון לחיוב לא יחויב יותר בדמי מינוי לפלטפורמת Earth Engine אחרי מחזור החיובים הנוכחי.

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

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

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