Method: projects.assets.getPixels

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

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

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

درخواست HTTP

POST https://earthengine.googleapis.com/v1alpha/{name=projects/*/assets/**}:getPixels

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

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

پارامترها
name

string

مورد نیاز. نام دارایی تصویری که از آن پیکسل ها دریافت می شود. name از قالب "projects/*/assets/**" است (به عنوان مثال، "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). همه دارایی‌های متعلق به کاربر تحت پروژه "میراث زمینی" قرار دارند (به عنوان مثال، "پروژه‌ها/جنبه-میراث/دارایی/کاربران/foo/bar"). همه دارایی های دیگر تحت پروژه "Earthengine-Public" هستند (به عنوان مثال، "projects/earthengine-public/assets/LANDSAT").

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

  • earthengine.assets.get

درخواست بدن

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

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

enum ( ImageFileFormat )

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

grid

object ( PixelGrid )

پارامترهایی که شبکه پیکسلی را برای واکشی داده ها توصیف می کند. پیش‌فرض شبکه پیکسلی داده‌ها.

region

object ( Struct format)

در صورت وجود، منطقه داده ای که باید برگردانده شود، به عنوان یک شی هندسی GeoJSON مشخص شده است (به RFC 7946 مراجعه کنید). از آنجایی که تصویر برگردانده شده همیشه مستطیل شکل است، جعبه مرزی هندسه داده شده در سیستم مختصات خروجی در واقع استفاده خواهد شد. اگر grid.dimensions نیز مشخص شده باشد، در نهایت شبکه به اندازه درخواستی تغییر مقیاس داده می شود.

bandIds[]

string

در صورت وجود، مجموعه خاصی از باندها را مشخص می کند که از آن پیکسل ها دریافت می شود. باندها با id مشخص می شوند، همانطور که با فیلد id یک پروتو ImageBand نشان داده شده است.

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 .

،

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

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

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

درخواست HTTP

POST https://earthengine.googleapis.com/v1alpha/{name=projects/*/assets/**}:getPixels

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

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

پارامترها
name

string

مورد نیاز. نام دارایی تصویری که از آن پیکسل ها دریافت می شود. name از قالب "projects/*/assets/**" است (به عنوان مثال، "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). همه دارایی‌های متعلق به کاربر تحت پروژه "میراث زمینی" قرار دارند (به عنوان مثال، "پروژه‌ها/جنبه-میراث/دارایی/کاربران/foo/bar"). همه دارایی های دیگر تحت پروژه "Earthengine-Public" هستند (به عنوان مثال، "projects/earthengine-public/assets/LANDSAT").

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

  • earthengine.assets.get

درخواست بدن

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

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

enum ( ImageFileFormat )

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

grid

object ( PixelGrid )

پارامترهایی که شبکه پیکسلی را برای واکشی داده ها توصیف می کند. پیش‌فرض شبکه پیکسلی داده‌ها.

region

object ( Struct format)

در صورت وجود، منطقه داده ای که باید برگردانده شود، به عنوان یک شی هندسی GeoJSON مشخص شده است (به RFC 7946 مراجعه کنید). از آنجایی که تصویر برگردانده شده همیشه مستطیل شکل است، جعبه مرزی هندسه داده شده در سیستم مختصات خروجی در واقع استفاده خواهد شد. اگر grid.dimensions نیز مشخص شده باشد، در نهایت شبکه به اندازه درخواستی تغییر مقیاس داده می شود.

bandIds[]

string

در صورت وجود، مجموعه خاصی از باندها را مشخص می کند که از آن پیکسل ها دریافت می شود. باندها با id مشخص می شوند، همانطور که با فیلد id یک پروتو ImageBand نشان داده شده است.

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 .

،

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

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

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

درخواست HTTP

POST https://earthengine.googleapis.com/v1alpha/{name=projects/*/assets/**}:getPixels

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

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

پارامترها
name

string

مورد نیاز. نام دارایی تصویری که از آن پیکسل ها دریافت می شود. name از قالب "projects/*/assets/**" است (به عنوان مثال، "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). همه دارایی‌های متعلق به کاربر تحت پروژه "میراث زمینی" قرار دارند (به عنوان مثال، "پروژه‌ها/جنبه-میراث/دارایی/کاربران/foo/bar"). همه دارایی های دیگر تحت پروژه "Earthengine-Public" هستند (به عنوان مثال، "projects/earthengine-public/assets/LANDSAT").

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

  • earthengine.assets.get

درخواست بدن

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

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

enum ( ImageFileFormat )

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

grid

object ( PixelGrid )

پارامترهایی که شبکه پیکسلی را برای واکشی داده ها توصیف می کند. پیش‌فرض شبکه پیکسلی داده‌ها.

region

object ( Struct format)

در صورت وجود، منطقه داده ای که باید برگردانده شود، به عنوان یک شی هندسی GeoJSON مشخص شده است (به RFC 7946 مراجعه کنید). از آنجایی که تصویر برگردانده شده همیشه مستطیل شکل است، جعبه مرزی هندسه داده شده در سیستم مختصات خروجی در واقع استفاده خواهد شد. اگر grid.dimensions نیز مشخص شده باشد، در نهایت شبکه به اندازه درخواستی تغییر مقیاس داده می شود.

bandIds[]

string

در صورت وجود، مجموعه خاصی از باندها را مشخص می کند که از آن پیکسل ها دریافت می شود. باندها با id مشخص می شوند، همانطور که با فیلد id یک پروتو ImageBand نشان داده شده است.

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 .

،

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

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

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

درخواست HTTP

POST https://earthengine.googleapis.com/v1alpha/{name=projects/*/assets/**}:getPixels

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

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

پارامترها
name

string

مورد نیاز. نام دارایی تصویری که از آن پیکسل ها دریافت می شود. name از قالب "projects/*/assets/**" است (به عنوان مثال، "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). همه دارایی‌های متعلق به کاربر تحت پروژه "میراث زمینی" قرار دارند (به عنوان مثال، "پروژه‌ها/جنبه-میراث/دارایی/کاربران/foo/bar"). همه دارایی های دیگر تحت پروژه "Earthengine-Public" هستند (به عنوان مثال، "projects/earthengine-public/assets/LANDSAT").

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

  • earthengine.assets.get

درخواست بدن

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

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

enum ( ImageFileFormat )

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

grid

object ( PixelGrid )

پارامترهایی که شبکه پیکسلی را برای واکشی داده ها توصیف می کند. پیش‌فرض شبکه پیکسلی داده‌ها.

region

object ( Struct format)

در صورت وجود، منطقه داده ای که باید برگردانده شود، به عنوان یک شی هندسی GeoJSON مشخص شده است (به RFC 7946 مراجعه کنید). از آنجایی که تصویر برگردانده شده همیشه مستطیل شکل است، جعبه مرزی هندسه داده شده در سیستم مختصات خروجی در واقع استفاده خواهد شد. اگر grid.dimensions نیز مشخص شده باشد، در نهایت شبکه به اندازه درخواستی تغییر مقیاس داده می شود.

bandIds[]

string

در صورت وجود، مجموعه خاصی از باندها را مشخص می کند که از آن پیکسل ها دریافت می شود. باندها با id مشخص می شوند، همانطور که با فیلد id یک پروتو ImageBand نشان داده شده است.

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 .