עזרה

באיזה נושא דרושה לך עזרה? (click link)

טיפים לקבלת עזרה

"איך אוכל לעזור לאחרים לעזור לי?"

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

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

הוספת שאלה

איזה סוג של שאלה יש לך? (אפשר ללחוץ על הקישורים כדי לקבל מידע נוסף או להרחיב את האפשרויות כדי לראות דוגמאות)

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

  • איך מסירים מאוסף המאפיינים מאפיינים עם ערכים מחושבים של null?
  • איך משלבים אוסף תכונות עם אוסף תמונות לפי מיקום ותאריך?
  • למה אוסף התכונות שלי ריק?

שאלת דיון: נושאים שנויים במחלוקת, דיון, חישה מרחוק, מתודולוגיה

  • מה הדרך הטובה ביותר לטפל בפערים של SLC-off ב-Landsat 7?
  • איך אפשר להחריג פיקסלים של מים מהניתוח?
  • למה ניתוח ב-ArcGIS מניב תוצאה שונה מזו של Earth Engine?
  • אני חושב שמצאתי באג – האם משתמשים אחרים נתקלו באותה בעיה?

GIS Stack Exchange

אתם יכולים לפרסם שאלות טכניות ב-Geographic Information Systems Stack Exchange‏ (GIS SE), אתר מבוסס-קהילה של שאלות ותשובות לאפליקציות גיאוגרפיות.

אסור לפרסם את הניתוח המלא ולבקש מקהילת המפתחים לנפות באגים בקוד.

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

צריך להשתמש בתג 'google-earth-engine' ב-Stack Exchange.

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

הדוגמה הזו יכולה לשמש כמדריך לאופן שבו צריך להגדיר את השאלה ולסמן אותה:

Title:

למה התוצאות של ee.Reducer.fixedHistogram() הן חלקיות? (Earth Engine)

Body:

Markdownעיבוד
I am calculating a histogram for an area of interest using
`ee.Reducer.fixedHistogram()`. The pixel count per bin is often a fraction,
but not always. I was expecting integer results only, why are the results
fractions of a pixel?

Here is my code; inspect the histogram table to see the results.

```js
// Define an image.
var img = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_038029_20180810');

// Define an area of interest.
var aoi = ee.Geometry.Rectangle(-110.5, 44.6, -110.1, 44.8);

// Calculate a histogram for the pixels in the API.
var reflHistDict = img.select('B[1-7]').multiply(1e4).reduceRegion({
  reducer: ee.Reducer.fixedHistogram(0, 5000, 250),
  geometry: aoi,
  scale: 30
});

// A dictionary was returned, get the ee.Array results for SWIR1 band.
var swir1HistArray = ee.Array(reflHistDict.get('B6'));
print(swir1HistArray);
```

[Code Editor
script](https://code.earthengine.google.com/d5c15787d1e468c5668836399fa8652f?as_external)

אני מחשב היסטוגרמה של אזור עניין באמצעות ee.Reducer.fixedHistogram(). לרוב, מספר הפיקסלים בכל קטגוריה הוא סכום חלקי, אבל לא תמיד. ציפיתי לקבל תוצאות של מספרים שלמים בלבד, למה התוצאות הן שברים של פיקסל?

זה הקוד שלי. אפשר לבדוק את התוצאות בטבלת ההיסטוגרמה.

// Define an image.
var img = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_038029_20180810');

// Define an area of interest.
var aoi = ee.Geometry.Rectangle(-110.5, 44.6, -110.1, 44.8);

// Calculate a histogram for the pixels in the API.
var reflHistDict = img.select('B[1-7]').multiply(1e4).reduceRegion({
  reducer: ee.Reducer.fixedHistogram(0, 5000, 250),
  geometry: aoi,
  scale: 30
});

// A dictionary was returned, get the ee.Array results for SWIR1 band.
var swir1HistArray = ee.Array(reflHistDict.get('B6'));
print(swir1HistArray);

סקריפט של Code Editor

פורום המפתחים של Earth Engine

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

דיווח על באג

איזה סוג באג מצאתם? (אפשר ללחוץ על הקישורים כדי לקבל מידע נוסף או להרחיב את האפשרויות כדי לראות דוגמאות)

באג ב-API: שגיאות בסקריפט או תוצאות שגויות

  • תוצאה בלתי צפויה או שגויה של פונקציה
  • שגיאה לא מוכרת
  • הודעות שגיאה פנימיות
  • שגיאות שלא ניתן לפתור באמצעות שיטות נפוצות לניפוי באגים
  • סקריפט שפועל ולא השתנה מזמן מה, עכשיו לא פועל
  • במסמכי התיעוד של ה-API חסר מידע קריטי
  • בעיות שקשורות לנכסים ב-Data Catalog

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

  • סקריפטים לא נטענים
  • הלחצנים לא פועלים
  • פריסה מוזרה
  • רכיבי דף חסרים
  • האינטראקציה עם המפה לא פועלת
  • החיפוש ב-Data Catalog לא פועל

באג במערך נתונים

  • חסרים נכסים
  • בעיות בהקרנה
  • תיאורים לא ברורים של מערכי נתונים

API

כדי לדווח על באג, פועלים לפי ההוראות הבאות:

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

עורך קוד

כדי לדווח על באג שקשור לממשק של Code Editor, פותחים את Code Editor, לוחצים על הלחצן ואז על Send Code Editor feedback. יופיע חלון שבו תוכלו לתאר את הבעיה. תוכלו גם לסמן צילום מסך כדי להדגיש את מיקום הבעיה.

בעיה במערך הנתונים

כאן אפשר לדווח על באג. אם אפשר, יש לספק קישור ל-Code Editor שבו מוצגת הבעיה.

בעיות ברישום

כדי להגדיר את הגישה, נכנסים לדף הרישום של Earth Engine.

אם נתקלת בבעיות שקשורות לרישום או לגישה ל-Earth Engine, אפשר לבקש עזרה מצוות התמיכה של Earth Engine Registration.

הודעות שגיאה

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

  1. המדריך לניפוי באגים יכול לשמש כמקור מידע ראשוני כדי להבין איזה סוג שגיאה קיבלתם ואיך אפשר לפתור אותה.
  2. מבצעים חיפוש ב-Google של הודעת השגיאה. התוצאות הן בדרך כלל מ-GIS Stack Exchange.
  3. מחפשים את הודעת השגיאה בפורום למפתחים כדי לראות אם משתמשים אחרים נתקלו באותה בעיה.
  4. אם אחרי שעיינתם בכל המשאבים הזמינים עדיין לא ברור לכם מה גורם לשגיאה, תוכלו לפרסם שאלה.
  5. לבסוף, אם השגיאה לא נפתרה ואתם חושדים שמדובר בבאג, דווחו על כך.

מכסה נוספת

שימוש לא מסחרי או לצורכי מחקר

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

אתם יכולים לבקש הגדלה של המכסות הבאות:

  • מכסת אחסון נכסים, שמגבילה את כמות נתוני הנכסים שמשתמש יכול לאחסן במאגר הנכסים ב-EE.
  • מכסה למשימות באצווה, שמגדירה את מספר המשימות המקבילות שמשתמש יכול להריץ בסביבה של האצווה. סביבת האצווה מספקת תוצאות חישוב אסינכרוני בצורת קבצים שנשלחים לאחסון של Earth Engine, ל-Google Cloud Storage או ל-Google Drive.
  • מכסת מקביליות של בקשות לסביבה האינטראקטיבית, שמגבילה את הקצב והמקביליות של השאילתות לשירות Earth Engine.

טופס הגשת מועמדות

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

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

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

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

שימוש מסחרי

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

בקשות לגבי מערכי נתונים

כדי לבקש מערך נתונים חדש או לדווח על באג במערך נתונים קיים:

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

בקשות להוספת תכונות

כדי לבקש תכונה חדשה של API או של Code Editor, פועלים לפי ההוראות הבאות:

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

שינוי בהתנהגות או בפלט של הסקריפט

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

  1. מוודאים שלא בוצעו שינויים בסקריפט – בודקים את היסטוריית הסקריפט.
  2. מוודאים שלא בוצעו שינויים באוסף הקלט (למשל, האם מסננים את תאריכי התמונות עד היום, ועכשיו יש תמונות חדשות באוסף?).
  3. האם אתם מסתמכים על מודולים של סקריפטים מיובאים או על נכסים משותפים שכבר לא זמינים או השתנו?
  4. האם זהו אותו סקריפט שפועל באזור עניין או במערך נתונים אחר?

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

חסרים נכסי קטלוג

במדריך הזה מוסבר איך לאשר נכס חסר ב-Earth Engine Data Catalog ולדווח עליו.

לעזור לאחרים

יש כמה דרכים לעזור לאחרים: