Method: projects.image.import

ייבוא תמונה.

בקשת HTTP

POST https://earthengine.googleapis.com/v1/{project=projects/*}/image:import

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
project

string

מזהה הפרויקט או מספר הפרויקט ב-Google Cloud Platform שצריך להתייחס אליו כצרכן השירות של הבקשה הזו. הפורמט הוא projects/{project-id}.

כדי לקבל הרשאה, נדרשת ההרשאה הבאה ב-IAM למשאב שצוין project:

  • earthengine.imports.create

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "imageManifest": {
    object (ImageManifest)
  },
  "description": string,
  "overwrite": boolean,
  "requestId": string
}
שדות
imageManifest

object (ImageManifest)

המניפסט של התמונה.
description

string

שם המשימה שקריא לבני אדם.
overwrite

boolean

האם לאפשר החלפה של נכס קיים.
requestId

string

מחרוזת ייחודית המשמשת לזיהוי בקשות כפולות. אם אותו משתמש שולח יותר מבקשה אחת עם אותו requestId לא ריק, רק אחת מהבקשות האלה עשויה להתחיל פעולה ממושכת. השדה requestId יכול להכיל את התווים a..z,‏ A..Z,‏ 0-9 או '-'. האורך המקסימלי של השדה requestId הוא 60 תווים.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של Operation.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform

מידע נוסף זמין בOAuth 2.0 Overview.

ImageManifest

תיאור האופן שבו שירות EarthEngine צריך ליצור תמונה מקבוצת קבצים.

ייצוג ב-JSON 
{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "tilesets": [
    {
      object (Tileset)
    }
  ],
  "bands": [
    {
      object (TilesetBand)
    }
  ],
  "maskBands": [
    {
      object (TilesetMaskBand)
    }
  ],
  "footprint": {
    object (PixelFootprint)
  },
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy),
  "startTime": string,
  "endTime": string,
  "skipMetadataRead": boolean,
  "memo": string
}
שדות
name

string

השם של הנכס שייווצר. name צריך להיות בפורמט 'projects/*/assets/**' (למשל 'projects/earthengine-legacy/assets/users//'). כל הנכסים שבבעלות משתמשים נמצאים בפרויקט earthengine-legacy (למשל, projects/earthengine-legacy/assets/users/foo/bar). כל שאר הנכסים נמצאים בפרויקט earthengine-public (למשל, projects/earthengine-public/assets/LANDSAT).
properties

object (Struct format)

מאפיינים נוספים של הנכס. שמות המאפיינים system:time_start ו-system:time_end הוצאו משימוש. במקום זאת, משתמשים בשדות startTime ו-endTime.
uriPrefix

string

הקידומת האופציונלית שמתווספת לכל הערכים של uri שמוגדרים במניפסט הזה.
tilesets[]

object (Tileset)

ערכות האריחים. לכל קבוצת משבצות חייב להיות מזהה ייחודי.
bands[]

object (TilesetBand)

הערוצים. סדר הלהקות בנכס זהה לסדר של bands.
maskBands[]

object (TilesetMaskBand)

רצועות המסכה.
footprint

object (PixelFootprint)

טביעת הרגל בקואורדינטות פיקסלים (לא בקואורדינטות רוחב/אורך). אם השדה ריק, ברירת המחדל היא שהמידה תהיה של כל התמונה. תיאור מפורט יותר של קואורדינטות פיקסלים זמין במאמר PixelGrid.
missingData

object (MissingData)

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

enum (PyramidingPolicy)

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

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

בנכסים שתואמים למרווח זמן מסוים, כמו ערכים ממוצעים לאורך חודש או שנה, חותמת הזמן הזו תואמת לסוף מרווח הזמן הזה (לא כולל).

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
skipMetadataRead

boolean

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

string

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

TilesetBand

מייצגת פס אחד שמקורו ב-tileset.

ייצוג ב-JSON 
{
  "id": string,
  "tilesetId": string,
  "tilesetBandIndex": integer,
  "missingData": {
    object (MissingData)
  },
  "pyramidingPolicy": enum (PyramidingPolicy)
}
שדות
id

string

המזהה של הלהקה.
tilesetId

string

המזהה של קבוצת המשבצות (tileset) התואמת לפס.
tilesetBandIndex

integer

אינדקס הלהקה שמתחיל ב-0 ממערך האריחים התואם ללהקה. לדוגמה, אם הערך הוא 1, הפיקסלים של הפס הם הפיקסלים של הפס במדד 1 של קבוצת האריחים (ב-ImageManifest.tilesets) עם המזהה tilesetId.
missingData

object (MissingData)

הערכים שמייצגים שאין נתונים בפס. אם MissingData מוגדר ללא values, המערכת תתעלם מכל ערך nodata שמוצג בקובצים התואמים ל-TilesetBand הזה.
pyramidingPolicy

enum (PyramidingPolicy)

מדיניות הפירמידה.

TilesetMaskBand

מייצגת פס מסכה יחיד שמקורו ב-tileset.

ייצוג ב-JSON 
{
  "tilesetId": string,
  "bandIds": [
    string
  ]
}
שדות
tilesetId

string

המזהה של קבוצת המשבצות שתואם לפס התממה. תמיד משתמשים בפס האחרון של קבוצת האריחים בתור פס המסכה.
bandIds[]

string

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

PixelFootprint

טביעת הרגל של כל הפיקסלים התקינים בתמונה.

ייצוג ב-JSON 
{
  "points": [
    {
      object (GridPoint)
    }
  ],
  "bandId": string
}
שדות
points[]

object (GridPoint)

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

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

לדוגמה, לתמונה בגודל 2x2 עם כל 4 הפיקסלים התקינים, זוהי טבעת אפשרית אחת: [{"x": 0.5, "y": 0.5}, {"x": 0.5, "y": 1.5}, {"x": 1.5, "y": 1.5}, {"x": 1.5, "y": 0.5}, {"x": 0.5, "y": 0.5}]
bandId

string

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

GridPoint

נקודה או וקטור דו-ממדיים.

ייצוג ב-JSON 
{
  "x": number,
  "y": number
}
שדות
x

number

ערך הקואורדינטה x.
y

number

הערך של קואורדינטת ה-y.