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,

  // 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 را پیکربندی می کند.