Method: projects.assets.getPixels
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پیکسل ها را از دارایی تصویر واکشی می کند. این روش سفارشی به تماس‌گیرنده اجازه می‌دهد تا یک کاشی دلخواه از پیکسل‌ها را از یک تصویر درخواست کند و به صورت اختیاری نوارها و طرح‌ریزی نقشه را مشخص کند. داده های پوشانده شده یا از دست رفته به صورت صفر کدگذاری می شوند.
درخواست‌ها به 48 مگابایت در داده‌های فشرده‌نشده در هر درخواست محدود می‌شوند که به‌عنوان حاصل ضرب ابعاد درخواست در پیکسل، تعداد باندهای تصویر درخواستی و تعداد بایت‌ها در هر پیکسل برای هر باند محاسبه می‌شود. درخواست ها همچنین به حداکثر 32K پیکسل در هر بعد و حداکثر 1024 باند محدود می شوند. درخواست های بیش از این محدودیت ها منجر به کد خطای 400 (BAD_REQUEST) می شود.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده های پیکسل درخواستی در کدگذاری مشخص شده در قسمت fileFormat درخواست است.
درخواست HTTP
POST https://earthengine.googleapis.com/v1/{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 منبع مشخص شده دارد: |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| فیلدها |
|---|
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/v1/{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 منبع مشخص شده دارد: |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| فیلدها |
|---|
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 .
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبت‌شده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eFetches pixel data from Earth Engine image assets, allowing users to specify bands, regions, and output formats.\u003c/p\u003e\n"],["\u003cp\u003eRequests are limited to 48MB uncompressed data, 32K pixels in each dimension, and 1024 bands; exceeding these limits results in a 400 error.\u003c/p\u003e\n"],["\u003cp\u003ePixel data can be returned in various formats, including raw data and visualizations based on specified parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization using one of the specified OAuth scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eUsers can provide a workload tag for tracking the computation.\u003c/p\u003e\n"]]],[],null,["# Method: projects.assets.getPixels\n\nFetches pixels from an image asset. This custom method allows the caller to request an arbitrary tile of pixels from an image, optionally specifying the bands and map projection. Masked or missing data will be encoded as zeroes.\n\nRequests are limited to 48MB in uncompressed data per request, computed as the product of the request dimensions in pixels, the number of image bands requested, and the number of bytes per pixel for each band. Requests are also limited to at most 32K pixels in either dimension and at most 1024 bands. Requests exceeding these limits will result in an error code of 400 (BAD_REQUEST).\n\nIf successful, the response body contains the requested pixel data in the encoding specified in the `fileFormat` field of the request.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1/{name=projects/*/assets/**}:getPixels`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the image asset from which to get pixels. `name` is of the format \"projects/\\*/assets/\\*\\*\" (e.g., \"projects/earthengine-legacy/assets/users/\\[USER\\]/\\[ASSET\\]\"). All user-owned assets are under the project \"earthengine-legacy\" (e.g., \"projects/earthengine-legacy/assets/users/foo/bar\"). All other assets are under the project \"earthengine-public\" (e.g., \"projects/earthengine-public/assets/LANDSAT\"). Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `name`: - `earthengine.assets.get` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"fileFormat\": enum (/earth-engine/reference/rest/v1/ImageFileFormat), \"grid\": { object (/earth-engine/reference/rest/v1/PixelGrid) }, \"region\": { object }, \"bandIds\": [ string ], \"visualizationOptions\": { object (/earth-engine/reference/rest/v1/VisualizationOptions) }, \"workloadTag\": string } ``` |\n\n| Fields ||\n|------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `fileFormat` | `enum (`[ImageFileFormat](/earth-engine/reference/rest/v1/ImageFileFormat)`)` The output file format in which to return the pixel values. |\n| `grid` | `object (`[PixelGrid](/earth-engine/reference/rest/v1/PixelGrid)`)` Parameters describing the pixel grid in which to fetch data. Defaults to the native pixel grid of the data. |\n| `region` | `object (`[Struct](https://protobuf.dev/reference/protobuf/google.protobuf/#struct)` format)` If present, the region of data to return, specified as a GeoJSON geometry object (see RFC 7946). Since the returned image is always rectangular, the bounding box of the given geometry in the output coordinate system will actually be used. If `grid.dimensions` is also specified then the grid will finally be rescaled to the requested size. |\n| `bandIds[]` | `string` If present, specifies a specific set of bands from which to get pixels. Bands are identified by id, as indicated by the `id` field of an ImageBand proto. |\n| `visualizationOptions` | `object (`[VisualizationOptions](/earth-engine/reference/rest/v1/VisualizationOptions)`)` If present, a set of visualization options to apply to produce an 8-bit RGB visualization of the data, rather than returning the raw data. |\n| `workloadTag` | `string` User supplied tag to track this computation. |\n\n### Response body\n\nIf successful, the response is a generic HTTP response whose format is defined by the method.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/earthengine.readonly`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
