Method: projects.video.export

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

طلب HTTP

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

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

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

المعلمات
project

string

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

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

  • earthengine.exports.create

نص الطلب

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

تمثيل JSON
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "videoOptions": {
    object (VideoOptions)
  },
  "fileExportOptions": {
    object (VideoFileExportOptions)
  },
  "requestId": string,
  "workloadTag": string,
  "priority": integer
}
الحقول
expression

object (Expression)

تعبير يُحتسب على أنّه الفيديو المطلوب احتسابه وتصديره، ويُمثَّل كمجموعة صور.

description

string

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

videoOptions

object (VideoOptions)

خيارات أساسية تصف الفيديو المطلوب إنشاؤه

fileExportOptions

object (VideoFileExportOptions)

خيارات لمكان تصدير الفيديو وتنسيقه

requestId

string

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

workloadTag

string

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

priority

integer

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال 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.

VideoFileExportOptions

خيارات تصدير الفيديوهات كملفات خارج Earth Engine

تمثيل JSON
{
  "fileFormat": enum (VideoFileFormat),

  // Union field destination can be only one of the following:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of list of possible types for union field destination.
}
الحقول
fileFormat

enum (VideoFileFormat)

تنسيق الملف الذي سيتم تصدير الفيديوهات به لا يتوفّر حاليًا سوى تنسيق MP4.

حقل الربط destination مكان كتابة النتائج يمكن أن يكون destination واحدًا فقط مما يلي:
driveDestination

object (DriveDestination)

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

cloudStorageDestination

object (CloudStorageDestination)

لضبط عملية التصدير إلى Google Cloud Storage، إذا تم تحديدها.