Method: projects.assets.getPixels

تُستخدَم هذه الدالة لجلب وحدات البكسل من مادة عرض صورة. تسمح هذه الطريقة المخصّصة للمتصل بطلب شريحة عشوائية من وحدات البكسل من صورة، مع تحديد النطاقات وطريقة عرض الخريطة اختياريًا. سيتم ترميز البيانات المخفية أو المفقودة على أنّها أصفار.

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

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

طلب HTTP

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

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

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

المعلمات
name

string

مطلوب. اسم مادة عرض الصورة التي يتم الحصول على البكسلات منها. يكون name بالتنسيق "projects/*/assets/**" (على سبيل المثال، "projects/earthengine-legacy/assets/users/[USER]/[ASSET]"). تندرج جميع مواد العرض التي يملكها المستخدمون ضمن المشروع "earthengine-legacy" (على سبيل المثال، "projects/earthengine-legacy/assets/users/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 من ملف ImageBand proto.
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.