إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
Method: projects.image.computePixels
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تُحسِّن هذه الوظيفة وحدات بكسل من خلال إجراء عملية حسابية عشوائية على بيانات الصورة.
تقتصر الطلبات على 48 ميغابايت من البيانات غير المضغوطة لكل طلب، ويتم احتسابها على أنّها حاصل ضرب أبعاد الطلب بالبكسل وعدد نطاقات الصور المطلوبة وعدد وحدات البايت لكل بكسل لكل نطاق. تقتصر الطلبات أيضًا على 32 ألف بكسل كحد أقصى في أي من الأبعاد و1024 نطاقًا كحد أقصى. سيؤدي تجاوز هذه الحدود القصوى إلى ظهور رمز الخطأ 400 (BAD_REQUEST).
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على بيانات البكسل المطلوبة بترميز محدّد في حقل fileFormat من الطلب.
طلب HTTP
POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/image:computePixels
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
project |
string
معرّف المشروع أو رقم المشروع على Google Cloud Platform الذي يجب التعامل معه كمستهلك الخدمة لهذا الطلب. التنسيق هو projects/{project-id}.
يتطلب التفويض إذن IAM التالي على المورد المحدّد project:
earthengine.computations.create
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| الحقول |
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.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis API computes a tile of pixels by performing a user-defined computation on image data using an expression.\u003c/p\u003e\n"],["\u003cp\u003eRequests are limited to 48MB of uncompressed data and specific dimensions, exceeding which results in a 400 error.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses contain pixel data in the specified file format, encoded within the HTTP response body.\u003c/p\u003e\n"],["\u003cp\u003eThe API requires authorization using specific OAuth scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/earthengine\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUsers can define the projection, clipping, band selection, and visualization options for the computed image within the request.\u003c/p\u003e\n"]]],["This API computes a tile of pixels from image data via an arbitrary expression. Input parameters include `expression`, `fileFormat`, `grid`, `bandIds`, `visualizationOptions`, and `workloadTag`. Requests are limited to 48MB of uncompressed data, 32K pixels per dimension, and 1024 bands, returning a 400 error code if these limits are exceeded. A successful request returns pixel data in the specified `fileFormat`, with authorization requiring specific OAuth scopes.\n"],null,["# Method: projects.image.computePixels\n\nComputes a tile of pixels by performing an arbitrary computation on image data.\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/v1beta/{project=projects/*}/image:computePixels`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `project` | `string` The project id or project number of the Google Cloud Platform project that should be treated as the service consumer for this request. Format is `projects/{project-id}`. Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `project`: - `earthengine.computations.create` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"expression\": { object (/earth-engine/reference/rest/v1beta/Expression) }, \"fileFormat\": enum (/earth-engine/reference/rest/v1beta/ImageFileFormat), \"grid\": { object (/earth-engine/reference/rest/v1beta/PixelGrid) }, \"bandIds\": [ string ], \"visualizationOptions\": { object (/earth-engine/reference/rest/v1beta/VisualizationOptions) }, \"workloadTag\": string } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `expression` | `object (`[Expression](/earth-engine/reference/rest/v1beta/Expression)`)` The expression to compute. |\n| `fileFormat` | `enum (`[ImageFileFormat](/earth-engine/reference/rest/v1beta/ImageFileFormat)`)` The output file format in which to return the pixel values. |\n| `grid` | `object (`[PixelGrid](/earth-engine/reference/rest/v1beta/PixelGrid)`)` Parameters describing how the image computed by `expression` should be reprojected and clipped. If not present, the full computed image is returned in its native projection. |\n| `bandIds[]` | `string` If present, specifies a specific set of bands that will be selected from the result of evaluating `expression`. If not present, all bands resulting from `expression` will be selected. |\n| `visualizationOptions` | `object (`[VisualizationOptions](/earth-engine/reference/rest/v1beta/VisualizationOptions)`)` If present, a set of visualization options to apply to produce an 8-bit RGB visualization of the 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)."]]
