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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "fileExportOptions": {
    object (ImageFileExportOptions)
  },
  "assetExportOptions": {
    object (ImageAssetExportOptions)
  }
  // End of mutually exclusive fields.
}
الحقول
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 إذا لم يتم تحديدها.
خيارات تصف مكان وكيفية تخزين النتائج في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
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),
    ...
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of mutually exclusive fields.
}
الحقول
pyramidingPolicy

enum (PyramidingPolicy)

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

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

عمليات إلغاء سياسة التدرّج الهرمي الخاصة بكل نطاق

كائن يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
مكان كتابة النتائج في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
earthEngineDestination

object (EarthEngineDestination)

إذا تم تحديد هذا الخيار، يتم ضبط التصدير إلى Earth Engine.
نهاية الحقول التي يستبعد كلّ منها الآخر