Method: projects.image.export

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

בקשת HTTP

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

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

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

פרמטרים
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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of mutually exclusive fields.
}
שדות
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.
אפשרויות שמתארות איפה ואיך לאחסן את התוצאות. בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
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),
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
שדות
pyramidingPolicy

enum (PyramidingPolicy)

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

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

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

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

object (EarthEngineDestination)

אם מציינים, המדיניות מגדירה ייצוא ל-Earth Engine.
סוף השדות הבלעדיים.