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 را پیکربندی می کند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eInitiates an image processing batch job, computing and saving the result to various destinations like Earth Engine assets or as a file.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying an expression to compute the image, a description for the task, and options for reprojection, clipping, and export destination.\u003c/p\u003e\n"],["\u003cp\u003eOffers control over export parameters, including maximum pixels, request identifiers for duplication detection, workload tagging, and task priority.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003ePOST\u003c/code\u003e method with the \u003ccode\u003ehttps://earthengine.googleapis.com/v1/{project=projects/*}/image:export\u003c/code\u003e endpoint for initiating the process.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with specific OAuth scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/earthengine\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"]]],["This documentation describes initiating an image export batch process via a POST request to `https://earthengine.googleapis.com/v1/{project=projects/*}/image:export`. The request body defines the `expression` to compute, task `description`, `maxPixels`, and `grid` parameters. It also includes a `requestId` and `workloadTag` for tracking and deduplication. The `export_options` field determines if the result is a `file` or an Earth Engine `asset`, with the `asset` having options for `pyramidingPolicy`. Authorization requires specific IAM permissions and OAuth scopes.\n"],null,[]]