یک فرآیند دستهای را آغاز میکند که یک نقشه کاشیکاری شده را محاسبه کرده و نتیجه را در فضای ذخیرهسازی ابری گوگل مینویسد.
درخواست HTTP
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/map:export
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
project | شناسه پروژه یا شماره پروژه پلتفرم ابری گوگل که باید به عنوان مصرفکننده سرویس برای این درخواست در نظر گرفته شود. فرمت آن مجوزدهی به مجوز IAM زیر در
|
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{ "expression": { object ( |
| فیلدها | |
|---|---|
expression | عبارتی که برای محاسبه و خروجی گرفتن به تصویر ارزیابی میشود. از مرزهای تصویر برای تعیین مجموعه کاشیهای نقشه برای رندر استفاده میشود. برای کنترل ناحیه خروجی، قبل از خروجی گرفتن، تصویر را برش دهید. |
description | نامی برای وظیفه که برای انسان قابل خواندن باشد. |
tileOptions | گزینههایی که کاشیهای نقشه برای تولید را توصیف میکنند. |
tileExportOptions | گزینههایی برای مکان و نحوهی خروجی گرفتن از کاشیهای نقشه. در حال حاضر، فضای ذخیرهسازی ابری تنها مقصد پشتیبانیشده برای خروجی گرفتن از نقشه است. |
requestId | یک رشته منحصر به فرد که برای تشخیص درخواستهای تکراری استفاده میشود. اگر بیش از یک درخواست توسط یک کاربر با |
workloadTag | برچسب ارائه شده توسط کاربر برای ردیابی این محاسبه. |
priority | اختیاری. اولویت وظیفه خروجی در پروژه. وظایف با اولویت بالاتر زودتر زمانبندی میشوند. باید یک عدد صحیح بین ۰ تا ۹۹۹۹ باشد. در صورت عدم تنظیم، پیشفرض ۱۰۰ است. |
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ شامل نمونهای از 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 |
|---|
{ "startZoom": integer, "minZoom": integer, "skipEmpty": boolean, "skipEmptyTiles": boolean, "mapsApiKey": string, "dimensions": { object ( |
| فیلدها | |
|---|---|
startZoom | سطح بزرگنمایی برای شروع تولید کاشیهای نقشه برای خروجی. مقدار پیشفرض صفر است. |
minZoom | سطح بزرگنمایی برای شروع تولید کاشیهای نقشه برای خروجی. مقدار پیشفرض صفر است. |
skipEmpty | اگر درست باشد، از نوشتن کاشیهای نقشه خالی (یعنی کاملاً شفاف) صرف نظر کن. |
skipEmptyTiles | اگر درست باشد، از نوشتن کاشیهای نقشه خالی (یعنی کاملاً شفاف) صرف نظر کن. |
mapsApiKey | کلید API پلتفرم نقشههای گوگل (اختیاری) برای نمایشگر کاشی نقشه تولید شده. |
dimensions | عرض و ارتفاع کاشیهای ویدیویی خروجی، که فقط برای خروجی گرفتن از هرمهای ویدیویی کاشیکاری شده (ExportVideoMap) استفاده میشود. |
tileDimensions | عرض و ارتفاع کاشیهای ویدیویی خروجی، که فقط برای خروجی گرفتن از هرمهای ویدیویی کاشیکاری شده (ExportVideoMap) استفاده میشود. |
stride | گام سطر و ستون کاشی. (ExportVideoMap) برای کاشیهای پراکنده روی ۴ (فقط WebGL) یا ۱ (پیشفرض) برای حداکثر سازگاری تنظیم کنید. |
zoomSubset | زیرمجموعهای از سطوح بزرگنمایی که برای تولید کاشیها استفاده میشود. فقط میتواند در فراخوانی |
| سطح بزرگنمایی یا مقیاسی که در آن تولید کاشیهای نقشه متوقف میشود. یکی از این دو باید مشخص شود. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد: | |
endZoom | سطح بزرگنمایی برای توقف تولید کاشیهای نقشه. |
maxZoom | سطح بزرگنمایی برای توقف تولید کاشیهای نقشه. |
scale | حداکثر وضوح تصویر بر حسب متر بر پیکسل. مقیاس به مناسبترین سطح بزرگنمایی حداکثر در خط استوا تبدیل خواهد شد. |
| پایان میدانهای ناسازگار. | |
زوم سابست
زیرمجموعهای از سطوح بزرگنمایی که برای تولید کاشیها استفاده میشود (ExportVideoMap)، زیرمجموعههای شروع و پایان مقادیری با دقت مضاعف هستند که به شما امکان میدهند سطح یا سطوح بزرگنمایی را به صورت تدریجی رندر کنید. برای رندر یک هرم کامل با بزرگنمایی شروع ۱۲: startZoom=0, endZoom=12، این پیام را تنظیم نکنید. برای رندر کردن سطوح ۰-۱۱ و ۱۰٪ اول سطح ۱۲: startZoom=0, endZoom=12, subset = {min=0, max=12.1 } برای رندر کردن ۱۰٪ بعدی سطح ۱۲: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } برای رندر کردن ۸۰٪ باقی مانده سطح ۱۲: startZoom=0, endZoom=12, subset = {min=12.2, max=13 } همچنین توجه داشته باشید که همه تکههای export باید اندازه هرم (کامل) یکسانی در start/endZoom داشته باشند.
| نمایش JSON |
|---|
{ "start": number, "end": number, "min": number, "max": number } |
| فیلدها | |
|---|---|
start | زیرمجموعه سطح بزرگنمایی شروع که برای آن کاشیها تولید میشوند (ExportVideoMap). در اینجا، subset یک مقدار با دقت مضاعف است که به شما امکان میدهد سطح بزرگنمایی را به صورت افزایشی رندر کنید، بنابراین برای مثال ۱۲.۱، ۱۰٪ اول کاشیها در بزرگنمایی ۱۲ به ترتیب نامشخص اما قطعی است. |
end | پایان دادن به زیرمجموعه سطح بزرگنمایی که برای آن کاشیها (ExportVideoMap) تولید میشوند، به شما این امکان را میدهد که یک سطح بزرگنمایی را به صورت تدریجی، تا حداکثر زیرمجموعه (در صورت ارائه) اما نه شامل آن، به ترتیب نامشخص اما قطعی ارائه دهید. |
min | زیرمجموعه سطح بزرگنمایی شروع که برای آن کاشیها تولید میشوند (ExportVideoMap). در اینجا، subset یک مقدار با دقت مضاعف است که به شما امکان میدهد سطح بزرگنمایی را به صورت افزایشی رندر کنید، بنابراین برای مثال ۱۲.۱، ۱۰٪ اول کاشیها در بزرگنمایی ۱۲ به ترتیب نامشخص اما قطعی است. |
max | پایان دادن به زیرمجموعه سطح بزرگنمایی که برای آن کاشیها (ExportVideoMap) تولید میشوند، به شما این امکان را میدهد که یک سطح بزرگنمایی را به صورت تدریجی، تا حداکثر زیرمجموعه (در صورت ارائه) اما نه شامل آن، به ترتیب نامشخص اما قطعی ارائه دهید. |
یک فرآیند دستهای را آغاز میکند که یک نقشه کاشیکاری شده را محاسبه کرده و نتیجه را در فضای ذخیرهسازی ابری گوگل مینویسد.
درخواست HTTP
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/map:export
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
project | شناسه پروژه یا شماره پروژه پلتفرم ابری گوگل که باید به عنوان مصرفکننده سرویس برای این درخواست در نظر گرفته شود. فرمت آن مجوزدهی به مجوز IAM زیر در
|
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{ "expression": { object ( |
| فیلدها | |
|---|---|
expression | عبارتی که برای محاسبه و خروجی گرفتن به تصویر ارزیابی میشود. از مرزهای تصویر برای تعیین مجموعه کاشیهای نقشه برای رندر استفاده میشود. برای کنترل ناحیه خروجی، قبل از خروجی گرفتن، تصویر را برش دهید. |
description | نامی برای وظیفه که برای انسان قابل خواندن باشد. |
tileOptions | گزینههایی که کاشیهای نقشه برای تولید را توصیف میکنند. |
tileExportOptions | گزینههایی برای مکان و نحوهی خروجی گرفتن از کاشیهای نقشه. در حال حاضر، فضای ذخیرهسازی ابری تنها مقصد پشتیبانیشده برای خروجی گرفتن از نقشه است. |
requestId | یک رشته منحصر به فرد که برای تشخیص درخواستهای تکراری استفاده میشود. اگر بیش از یک درخواست توسط یک کاربر با |
workloadTag | برچسب ارائه شده توسط کاربر برای ردیابی این محاسبه. |
priority | اختیاری. اولویت وظیفه خروجی در پروژه. وظایف با اولویت بالاتر زودتر زمانبندی میشوند. باید یک عدد صحیح بین ۰ تا ۹۹۹۹ باشد. در صورت عدم تنظیم، پیشفرض ۱۰۰ است. |
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ شامل نمونهای از 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 |
|---|
{ "startZoom": integer, "minZoom": integer, "skipEmpty": boolean, "skipEmptyTiles": boolean, "mapsApiKey": string, "dimensions": { object ( |
| فیلدها | |
|---|---|
startZoom | سطح بزرگنمایی برای شروع تولید کاشیهای نقشه برای خروجی. مقدار پیشفرض صفر است. |
minZoom | سطح بزرگنمایی برای شروع تولید کاشیهای نقشه برای خروجی. مقدار پیشفرض صفر است. |
skipEmpty | اگر درست باشد، از نوشتن کاشیهای نقشه خالی (یعنی کاملاً شفاف) صرف نظر کن. |
skipEmptyTiles | اگر درست باشد، از نوشتن کاشیهای نقشه خالی (یعنی کاملاً شفاف) صرف نظر کن. |
mapsApiKey | کلید API پلتفرم نقشههای گوگل (اختیاری) برای نمایشگر کاشی نقشه تولید شده. |
dimensions | عرض و ارتفاع کاشیهای ویدیویی خروجی، که فقط برای خروجی گرفتن از هرمهای ویدیویی کاشیکاری شده (ExportVideoMap) استفاده میشود. |
tileDimensions | عرض و ارتفاع کاشیهای ویدیویی خروجی، که فقط برای خروجی گرفتن از هرمهای ویدیویی کاشیکاری شده (ExportVideoMap) استفاده میشود. |
stride | گام سطر و ستون کاشی. (ExportVideoMap) برای کاشیهای پراکنده روی ۴ (فقط WebGL) یا ۱ (پیشفرض) برای حداکثر سازگاری تنظیم کنید. |
zoomSubset | زیرمجموعهای از سطوح بزرگنمایی که برای تولید کاشیها استفاده میشود. فقط میتواند در فراخوانی |
| سطح بزرگنمایی یا مقیاسی که در آن تولید کاشیهای نقشه متوقف میشود. یکی از این دو باید مشخص شود. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد: | |
endZoom | سطح بزرگنمایی برای توقف تولید کاشیهای نقشه. |
maxZoom | سطح بزرگنمایی برای توقف تولید کاشیهای نقشه. |
scale | حداکثر وضوح تصویر بر حسب متر بر پیکسل. مقیاس به مناسبترین سطح بزرگنمایی حداکثر در خط استوا تبدیل خواهد شد. |
| پایان میدانهای ناسازگار. | |
زوم سابست
زیرمجموعهای از سطوح بزرگنمایی که برای تولید کاشیها استفاده میشود (ExportVideoMap)، زیرمجموعههای شروع و پایان مقادیری با دقت مضاعف هستند که به شما امکان میدهند سطح یا سطوح بزرگنمایی را به صورت تدریجی رندر کنید. برای رندر یک هرم کامل با بزرگنمایی شروع ۱۲: startZoom=0, endZoom=12، این پیام را تنظیم نکنید. برای رندر کردن سطوح ۰-۱۱ و ۱۰٪ اول سطح ۱۲: startZoom=0, endZoom=12, subset = {min=0, max=12.1 } برای رندر کردن ۱۰٪ بعدی سطح ۱۲: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } برای رندر کردن ۸۰٪ باقی مانده سطح ۱۲: startZoom=0, endZoom=12, subset = {min=12.2, max=13 } همچنین توجه داشته باشید که همه تکههای export باید اندازه هرم (کامل) یکسانی در start/endZoom داشته باشند.
| نمایش JSON |
|---|
{ "start": number, "end": number, "min": number, "max": number } |
| فیلدها | |
|---|---|
start | زیرمجموعه سطح بزرگنمایی شروع که برای آن کاشیها تولید میشوند (ExportVideoMap). در اینجا، subset یک مقدار با دقت مضاعف است که به شما امکان میدهد سطح بزرگنمایی را به صورت افزایشی رندر کنید، بنابراین برای مثال ۱۲.۱، ۱۰٪ اول کاشیها در بزرگنمایی ۱۲ به ترتیب نامشخص اما قطعی است. |
end | پایان دادن به زیرمجموعه سطح بزرگنمایی که برای آن کاشیها (ExportVideoMap) تولید میشوند، به شما این امکان را میدهد که یک سطح بزرگنمایی را به صورت تدریجی، تا حداکثر زیرمجموعه (در صورت ارائه) اما نه شامل آن، به ترتیب نامشخص اما قطعی ارائه دهید. |
min | زیرمجموعه سطح بزرگنمایی شروع که برای آن کاشیها تولید میشوند (ExportVideoMap). در اینجا، subset یک مقدار با دقت مضاعف است که به شما امکان میدهد سطح بزرگنمایی را به صورت افزایشی رندر کنید، بنابراین برای مثال ۱۲.۱، ۱۰٪ اول کاشیها در بزرگنمایی ۱۲ به ترتیب نامشخص اما قطعی است. |
max | پایان دادن به زیرمجموعه سطح بزرگنمایی که برای آن کاشیها (ExportVideoMap) تولید میشوند، به شما این امکان را میدهد که یک سطح بزرگنمایی را به صورت تدریجی، تا حداکثر زیرمجموعه (در صورت ارائه) اما نه شامل آن، به ترتیب نامشخص اما قطعی ارائه دهید. |
یک فرآیند دستهای را آغاز میکند که یک نقشه کاشیکاری شده را محاسبه کرده و نتیجه را در فضای ذخیرهسازی ابری گوگل مینویسد.
درخواست HTTP
POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/map:export
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
project | شناسه پروژه یا شماره پروژه پلتفرم ابری گوگل که باید به عنوان مصرفکننده سرویس برای این درخواست در نظر گرفته شود. فرمت آن مجوزدهی به مجوز IAM زیر در
|
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{ "expression": { object ( |
| فیلدها | |
|---|---|
expression | عبارتی که برای محاسبه و خروجی گرفتن به تصویر ارزیابی میشود. از مرزهای تصویر برای تعیین مجموعه کاشیهای نقشه برای رندر استفاده میشود. برای کنترل ناحیه خروجی، قبل از خروجی گرفتن، تصویر را برش دهید. |
description | نامی برای وظیفه که برای انسان قابل خواندن باشد. |
tileOptions | گزینههایی که کاشیهای نقشه برای تولید را توصیف میکنند. |
tileExportOptions | گزینههایی برای مکان و نحوهی خروجی گرفتن از کاشیهای نقشه. در حال حاضر، فضای ذخیرهسازی ابری تنها مقصد پشتیبانیشده برای خروجی گرفتن از نقشه است. |
requestId | یک رشته منحصر به فرد که برای تشخیص درخواستهای تکراری استفاده میشود. اگر بیش از یک درخواست توسط یک کاربر با |
workloadTag | برچسب ارائه شده توسط کاربر برای ردیابی این محاسبه. |
priority | اختیاری. اولویت وظیفه خروجی در پروژه. وظایف با اولویت بالاتر زودتر زمانبندی میشوند. باید یک عدد صحیح بین ۰ تا ۹۹۹۹ باشد. در صورت عدم تنظیم، پیشفرض ۱۰۰ است. |
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ شامل نمونهای از 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 |
|---|
{ "startZoom": integer, "minZoom": integer, "skipEmpty": boolean, "skipEmptyTiles": boolean, "mapsApiKey": string, "dimensions": { object ( |
| فیلدها | |
|---|---|
startZoom | سطح بزرگنمایی برای شروع تولید کاشیهای نقشه برای خروجی. مقدار پیشفرض صفر است. |
minZoom | سطح بزرگنمایی برای شروع تولید کاشیهای نقشه برای خروجی. مقدار پیشفرض صفر است. |
skipEmpty | اگر درست باشد، از نوشتن کاشیهای نقشه خالی (یعنی کاملاً شفاف) صرف نظر کن. |
skipEmptyTiles | اگر درست باشد، از نوشتن کاشیهای نقشه خالی (یعنی کاملاً شفاف) صرف نظر کن. |
mapsApiKey | کلید API پلتفرم نقشههای گوگل (اختیاری) برای نمایشگر کاشی نقشه تولید شده. |
dimensions | عرض و ارتفاع کاشیهای ویدیویی خروجی، که فقط برای خروجی گرفتن از هرمهای ویدیویی کاشیکاری شده (ExportVideoMap) استفاده میشود. |
tileDimensions | عرض و ارتفاع کاشیهای ویدیویی خروجی، که فقط برای خروجی گرفتن از هرمهای ویدیویی کاشیکاری شده (ExportVideoMap) استفاده میشود. |
stride | گام سطر و ستون کاشی. (ExportVideoMap) برای کاشیهای پراکنده روی ۴ (فقط WebGL) یا ۱ (پیشفرض) برای حداکثر سازگاری تنظیم کنید. |
zoomSubset | زیرمجموعهای از سطوح بزرگنمایی که برای تولید کاشیها استفاده میشود. فقط میتواند در فراخوانی |
| سطح بزرگنمایی یا مقیاسی که در آن تولید کاشیهای نقشه متوقف میشود. یکی از این دو باید مشخص شود. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد: | |
endZoom | سطح بزرگنمایی برای توقف تولید کاشیهای نقشه. |
maxZoom | سطح بزرگنمایی برای توقف تولید کاشیهای نقشه. |
scale | حداکثر وضوح تصویر بر حسب متر بر پیکسل. مقیاس به مناسبترین سطح بزرگنمایی حداکثر در خط استوا تبدیل خواهد شد. |
| پایان میدانهای ناسازگار. | |
زوم سابست
زیرمجموعهای از سطوح بزرگنمایی که برای تولید کاشیها استفاده میشود (ExportVideoMap)، زیرمجموعههای شروع و پایان مقادیری با دقت مضاعف هستند که به شما امکان میدهند سطح یا سطوح بزرگنمایی را به صورت تدریجی رندر کنید. برای رندر یک هرم کامل با بزرگنمایی شروع ۱۲: startZoom=0, endZoom=12، این پیام را تنظیم نکنید. برای رندر کردن سطوح ۰-۱۱ و ۱۰٪ اول سطح ۱۲: startZoom=0, endZoom=12, subset = {min=0, max=12.1 } برای رندر کردن ۱۰٪ بعدی سطح ۱۲: startZoom=0, endZoom=12, subset = {min=12.1, max=12.2 } برای رندر کردن ۸۰٪ باقی مانده سطح ۱۲: startZoom=0, endZoom=12, subset = {min=12.2, max=13 } همچنین توجه داشته باشید که همه تکههای export باید اندازه هرم (کامل) یکسانی در start/endZoom داشته باشند.
| نمایش JSON |
|---|
{ "start": number, "end": number, "min": number, "max": number } |
| فیلدها | |
|---|---|
start | زیرمجموعه سطح بزرگنمایی شروع که برای آن کاشیها تولید میشوند (ExportVideoMap). در اینجا، subset یک مقدار با دقت مضاعف است که به شما امکان میدهد سطح بزرگنمایی را به صورت افزایشی رندر کنید، بنابراین برای مثال ۱۲.۱، ۱۰٪ اول کاشیها در بزرگنمایی ۱۲ به ترتیب نامشخص اما قطعی است. |
end | پایان دادن به زیرمجموعه سطح بزرگنمایی که برای آن کاشیها (ExportVideoMap) تولید میشوند، به شما این امکان را میدهد که یک سطح بزرگنمایی را به صورت تدریجی، تا حداکثر زیرمجموعه (در صورت ارائه) اما نه شامل آن، به ترتیب نامشخص اما قطعی ارائه دهید. |
min | زیرمجموعه سطح بزرگنمایی شروع که برای آن کاشیها تولید میشوند (ExportVideoMap). در اینجا، subset یک مقدار با دقت مضاعف است که به شما امکان میدهد سطح بزرگنمایی را به صورت افزایشی رندر کنید، بنابراین برای مثال ۱۲.۱، ۱۰٪ اول کاشیها در بزرگنمایی ۱۲ به ترتیب نامشخص اما قطعی است. |
max | پایان دادن به زیرمجموعه سطح بزرگنمایی که برای آن کاشیها (ExportVideoMap) تولید میشوند، به شما این امکان را میدهد که یک سطح بزرگنمایی را به صورت تدریجی، تا حداکثر زیرمجموعه (در صورت ارائه) اما نه شامل آن، به ترتیب نامشخص اما قطعی ارائه دهید. |