Method: projects.image.computePixels

با انجام یک محاسبه دلخواه روی داده های تصویر، یک کاشی از پیکسل ها را محاسبه می کند.

درخواست‌ها به 48 مگابایت در داده‌های فشرده‌نشده در هر درخواست محدود می‌شوند که به‌عنوان حاصل ضرب ابعاد درخواست در پیکسل، تعداد باندهای تصویر درخواستی و تعداد بایت‌ها در هر پیکسل برای هر باند محاسبه می‌شود. درخواست ها همچنین به حداکثر 32K پیکسل در هر بعد و حداکثر 1024 باند محدود می شوند. درخواست های بیش از این محدودیت ها منجر به کد خطای 400 (BAD_REQUEST) می شود.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده های پیکسل درخواستی در کدگذاری مشخص شده در قسمت fileFormat درخواست است.

درخواست HTTP

POST https://earthengine.googleapis.com/v1alpha/{project=projects/*}/image:computePixels

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
project

string

شناسه پروژه یا شماره پروژه پروژه Google Cloud Platform که باید به عنوان مصرف کننده سرویس برای این درخواست در نظر گرفته شود. قالب projects/{project-id} است.

مجوز نیاز به مجوز IAM زیر در project منبع مشخص شده دارد:

  • earthengine.computations.create

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "expression": {
    object (Expression)
  },
  "fileFormat": enum (ImageFileFormat),
  "grid": {
    object (PixelGrid)
  },
  "bandIds": [
    string
  ],
  "visualizationOptions": {
    object (VisualizationOptions)
  },
  "workloadTag": string
}
فیلدها
expression

object ( Expression )

عبارت برای محاسبه.

fileFormat

enum ( ImageFileFormat )

فرمت فایل خروجی که در آن مقادیر پیکسل برگردانده می شود.

grid

object ( PixelGrid )

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

bandIds[]

string

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

visualizationOptions

object ( VisualizationOptions )

در صورت وجود، مجموعه‌ای از گزینه‌های تجسم برای ایجاد تصویرسازی RGB 8 بیتی از داده‌ها اعمال می‌شود.

workloadTag

string

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

بدن پاسخگو

در صورت موفقیت آمیز بودن، پاسخ یک پاسخ HTTP عمومی است که قالب آن با روش تعریف شده است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/earthengine.readonly
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .