Method: projects.image.export

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

בקשת HTTP

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:export

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

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

פרמטרים
project

string

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

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

  • earthengine.exports.create

גוף הבקשה

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

ייצוג ב-JSON 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of list of possible types for union field export_options.
}
שדות
expression

object (Expression)

ביטוי שמתקבלת ממנו התמונה לחישוב ולייצוא.
description

string

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

string (Int64Value format)

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

object (PixelGrid)

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

string

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

string

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

integer

זה שינוי אופציונלי. העדיפות של משימה הייצוא בפרויקט. משימות בעדיפות גבוהה יותר מתוזמנות מוקדם יותר. חייב להיות מספר שלם בין 0 ל-9999. אם לא מגדירים ערך, ערך ברירת המחדל הוא 100.
שדה האיחוד export_options. אפשרויות שמתארות איפה ואיך לשמור את התוצאות. הערך של export_options יכול להיות רק אחת מהאפשרויות הבאות:
fileExportOptions

object (ImageFileExportOptions)

אם מצוין, מגדיר את הייצוא כקובץ.
assetExportOptions

object (ImageAssetExportOptions)

אם מצוין, מגדיר את הייצוא כנכס ב-Earth Engine.

גוף התשובה

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

היקפי הרשאה

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

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

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

ImageAssetExportOptions

אפשרויות לשמירת תמונות כנכסים ב-Earth Engine.

ייצוג ב-JSON 
{
  "pyramidingPolicy": enum (PyramidingPolicy),
  "pyramidingPolicyOverrides": {
    string: enum (PyramidingPolicy),
    ...
  },

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
שדות
pyramidingPolicy

enum (PyramidingPolicy)

המדיניות של יצירת היררכיות של מודעות שחלה כברירת מחדל על כל הלהקות.
pyramidingPolicyOverrides

map (key: string, value: enum (PyramidingPolicy))

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

אובייקט שמכיל רשימה של זוגות "key": value. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
שדה האיחוד destination. איפה לכתוב את התוצאות. הערך של destination יכול להיות רק אחת מהאפשרויות הבאות:
earthEngineDestination

object (EarthEngineDestination)

אם מצוין, מגדיר ייצוא ל-Earth Engine.