Method: projects.image.computePixels

تُحسِّن هذه الوظيفة وحدات بكسل من خلال إجراء عملية حسابية عشوائية على بيانات الصورة.

تقتصر الطلبات على 48 ميغابايت من البيانات غير المضغوطة لكل طلب، ويتم احتسابها على أنّها حاصل ضرب أبعاد الطلب بالبكسل وعدد نطاقات الصور المطلوبة وعدد وحدات البايت لكل بكسل لكل نطاق. تقتصر الطلبات أيضًا على 32 ألف بكسل كحد أقصى في أي من الأبعاد و1024 نطاقًا كحد أقصى. سيؤدي تجاوز هذه الحدود القصوى إلى ظهور رمز الخطأ 400 (BAD_REQUEST).

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على بيانات البكسل المطلوبة بترميز محدّد في حقل fileFormat من الطلب.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
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.