Method: projects.image.export

يبدأ عملية مجمّعة تحسب صورة وتكتب النتيجة في أحد الوجهات المتعددة.

طلب HTTP

POST https://earthengine.googleapis.com/v1beta/{project=projects/*}/image:export

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

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

المعلمات
project

string

معرّف المشروع أو رقم المشروع على Google Cloud Platform الذي يجب التعامل معه كمستهلك الخدمة لهذا الطلب. التنسيق هو projects/{project-id}.

يتطلب التفويض إذن IAM التالي على المورد المحدّد project:

  • earthengine.exports.create

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "maxPixels": string,
  "grid": {
    object (PixelGrid)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of list of possible types for union field export_options.
}
الحقول
expression

object (Expression)

تعبير يُحتسب على أنّه الصورة المطلوب احتسابها وتصديرها
description

string

اسم المهمة الذي يمكن لشخص عادي قراءته
maxPixels

string (Int64Value format)

الحد الأقصى لعدد وحدات البكسل التي سيتم احتسابها وتصديرها هذه ميزة أمان تمنعك من بدء عملية تصدير أكبر حجمًا مما كنت تريده عن طريق الخطأ. القيمة التلقائية هي 1e8 بكسل، ولكن يمكنك ضبط القيمة صراحةً لرفع هذا الحد أو خفضه.
grid

object (PixelGrid)

مَعلمات تصف كيفية إعادة إسقاط الصورة التي تم احتسابها بواسطة expression واقتصاصها وفي حال عدم توفّر هذا الحقل، يتم عرض الصورة المحسوبة بالكامل في الإسقاط الأصلي.
requestId

string

سلسلة فريدة تُستخدَم لرصد الطلبات المكرّرة إذا قدّم المستخدم نفسه أكثر من طلب واحد باستخدام requestId غير فارغ نفسه، قد يبدأ أحد هذه الطلبات فقط عملية طويلة الأمد بنجاح. يمكن أن يحتوي requestId على الأحرف a..z أو A..Z أو 0-9 أو "-". يمكن أن يتألّف requestId من 60 حرفًا كحدّ أقصى.
workloadTag

string

تصنيف يوفّره المستخدِم لتتبُّع عملية الحساب هذه
priority

integer

اختياريّ. أولوية مهمة التصدير ضمن المشروع يتم تحديد موعد مبكر للمهام ذات الأولوية الأعلى. يجب أن تكون القيمة عددًا صحيحًا بين 0 و9999. يتم ضبط القيمة تلقائيًا على 100 إذا لم يتم ضبطها.
حقل الربط export_options خيارات تصف مكان تخزين النتائج وكيفية تخزينها يمكن أن يكون export_options واحدًا فقط مما يلي:
fileExportOptions

object (ImageFileExportOptions)

في حال تحديدها، يتم ضبط التصدير كملف.
assetExportOptions

object (ImageAssetExportOptions)

في حال تحديده، يتم ضبط التصدير على أنّه مادة عرض في Earth Engine.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/earthengine
  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/devstorage.full_control

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

ImageAssetExportOptions

خيارات حفظ الصور كمواد عرض في Earth Engine

تمثيل JSON 
{
  "pyramidingPolicy": enum (PyramidingPolicy),
  "pyramidingPolicyOverrides": {
    string: enum (PyramidingPolicy),
    ...
  },

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
الحقول
pyramidingPolicy

enum (PyramidingPolicy)

تطبيق سياسة التجميع على جميع النطاقات تلقائيًا
pyramidingPolicyOverrides

map (key: string, value: enum (PyramidingPolicy))

إلغاء سياسة الهرم المحدّدة لكل نطاق

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
حقل الربط destination مكان كتابة النتائج يمكن أن يكون destination واحدًا فقط مما يلي:
earthEngineDestination

object (EarthEngineDestination)

في حال تحديده، يتم ضبط التصدير إلى Earth Engine.