Method: projects.image.export

یک فرآیند دسته‌ای را آغاز می‌کند که یک تصویر را محاسبه کرده و نتیجه را در یکی از چندین مقصد می‌نویسد.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
project

string

شناسه پروژه یا شماره پروژه پلتفرم ابری گوگل که باید به عنوان مصرف‌کننده سرویس برای این درخواست در نظر گرفته شود. فرمت آن 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)

حداکثر تعداد پیکسل‌ها برای محاسبه و خروجی گرفتن. این یک محافظ امنیتی است تا از شروع تصادفی خروجی بزرگتر از آنچه در نظر داشتید جلوگیری کند. مقدار پیش‌فرض ۱e۸ پیکسل است، اما می‌توانید مقدار را به طور صریح برای افزایش یا کاهش این محدودیت تنظیم کنید.

grid

object ( PixelGrid )

پارامترهایی که نحوه نمایش مجدد و برش تصویر محاسبه شده توسط expression را توصیف می‌کنند. در صورت عدم وجود، تصویر محاسبه شده کامل در تصویر اصلی خود بازگردانده می‌شود.

requestId

string

یک رشته منحصر به فرد که برای تشخیص درخواست‌های تکراری استفاده می‌شود. اگر بیش از یک درخواست توسط یک کاربر با requestId غیر خالی یکسان انجام شود، فقط یکی از آن درخواست‌ها می‌تواند با موفقیت یک عملیات طولانی مدت را آغاز کند. requestId می‌تواند شامل کاراکترهای a..z، A..Z، 0-9 یا '-' باشد. requestId می‌تواند حداکثر 60 کاراکتر داشته باشد.

workloadTag

string

برچسب ارائه شده توسط کاربر برای ردیابی این محاسبه.

priority

integer

اختیاری. اولویت وظیفه خروجی در پروژه. وظایف با اولویت بالاتر زودتر زمان‌بندی می‌شوند. باید یک عدد صحیح بین ۰ تا ۹۹۹۹ باشد. در صورت عدم تنظیم، پیش‌فرض ۱۰۰ است.

گزینه‌هایی که محل و نحوه ذخیره نتایج را توصیف می‌کنند. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
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 .

گزینه‌های خروجی تصویر

گزینه‌هایی برای ذخیره تصاویر به عنوان دارایی‌های موتور زمین.

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

پایان میدان‌های ناسازگار.