Method: projects.image.export
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
یک فرآیند دسته ای را آغاز می کند که یک تصویر را محاسبه می کند و نتیجه را در یکی از چندین مقصد می نویسد.
درخواست HTTP
POST https://earthengine.googleapis.com/v1beta/{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-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eInitiates a batch process to compute and export an image to various destinations.\u003c/p\u003e\n"],["\u003cp\u003eDefines parameters for image computation including expression, description, pixel limits, and reprojection.\u003c/p\u003e\n"],["\u003cp\u003eOffers options to configure the export as a file or an Earth Engine asset with customizable settings.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access and execution.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes an HTTP POST request to the Earth Engine API for initiating the process.\u003c/p\u003e\n"]]],["This API initiates a batch process to export a computed image. It requires a `project` identifier and accepts parameters within a request body, including an `expression` to define the image, a `description`, and `maxPixels`. It supports specifying a `grid` for reprojection, a `requestId` for request deduplication, `workloadTag` for tracking, and `priority` setting. The output can be exported as a file or an Earth Engine asset, with corresponding configuration options (`fileExportOptions` or `assetExportOptions`). Authentication requires specific OAuth scopes.\n"],null,[]]