עזרה

במה אפשר לעזור לך? (לחיצה על הקישור)

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

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

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

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

הוספת שאלה

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

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

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

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

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

GIS Stack Exchange

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

טיפים לניסוח שאלה טובה

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

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

מומלץ להשתמש בתג google-earth-engine ב-Stack Exchange.

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

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

תפקיד:

למה התוצאות של 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

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

בעיה בקבוצת נתונים

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

בעיות בהרשמה

כדי להגדיר את הגישה, צריך לעבור אל דף ההרשמה של Earth Engine.

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

תשלומים וחיובים

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

כדי לקבל את התוצאות הטובות ביותר, מומלץ לבצע את השלבים הבאים:

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

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

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

הודעות שגיאה

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

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

רמות חישוב

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

שימוש מסחרי

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

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

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

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

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

לפני שליחת הבקשה

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

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

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

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

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

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

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

כדי לבקש תכונה חדשה ב-API או בעורך הקוד:

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

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

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

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

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

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

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

עזרה לאחרים

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