Method: projects.table.export

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

طلب HTTP

POST https://earthengine.googleapis.com/v1/{project=projects/*}/table:export

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

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

المعلمات
project

string

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

يتطلّب منح الإذن إذن إدارة الهوية وإمكانية الوصول التالي على المورد المحدّد project:

  • earthengine.exports.create

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "selectors": [
    string
  ],
  "requestId": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "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 (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  },
  "bigqueryExportOptions": {
    object (BigQueryExportOptions)
  }
  // End of mutually exclusive fields.
}
الحقول
expression

object (Expression)

تعبير يتم تقييمه إلى الجدول المطلوب حسابه وتصديره.
description

string

اسم المهمة الذي يمكن للمستخدم قراءته
selectors[]

string

قائمة صريحة بالأعمدة المطلوب تضمينها في النتيجة
requestId

string

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

number

الحدّ الأقصى المسموح به للخطأ بالأمتار عند تحويل الأشكال الهندسية بين أنظمة الإحداثيات إذا كانت فارغة، يكون الحدّ الأقصى للخطأ مترًا واحدًا تلقائيًا.
maxVertices

integer

الحد الأقصى لعدد الرؤوس غير المقطوعة لكل شكل هندسي، وسيتم تقسيم الأشكال الهندسية التي تحتوي على المزيد من الرؤوس إلى أجزاء أصغر من هذا الحجم.
workloadTag

string

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

integer

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

object (TableFileExportOptions)

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

object (TableAssetExportOptions)

في حال تحديدها، يتم ضبط عملية التصدير كمادة عرض في Earth Engine.
featureViewExportOptions

object (FeatureViewAssetExportOptions)

في حال تحديدها، يتم ضبط عملية التصدير كخريطة FeatureView.
bigqueryExportOptions

object (BigQueryExportOptions)

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

نص الاستجابة

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

TableFileExportOptions

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "driveDestination": {
    object (DriveDestination)
  },
  "cloudStorageDestination": {
    object (CloudStorageDestination)
  }
  // End of mutually exclusive fields.
}
الحقول
fileFormat

enum (TableFileFormat)

تنسيق الملف الذي سيتم تصدير الجداول به
مكان كتابة النتائج في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
driveDestination

object (DriveDestination)

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

object (CloudStorageDestination)

في حال تحديدها، يتم ضبط عملية التصدير إلى Google Cloud Storage.
نهاية الحقول التي يستبعد كلّ منها الآخر

TableAssetExportOptions

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

تمثيل JSON 
{

  // 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.
}
الحقول
مكان كتابة النتائج في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
earthEngineDestination

object (EarthEngineDestination)

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

FeatureViewAssetExportOptions

خيارات لحفظ الجداول أو FeatureCollections كخرائط FeatureView

تمثيل JSON 
{
  "ingestionTimeParameters": {
    object (FeatureViewIngestionTimeParameters)
  },

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

object (FeatureViewIngestionTimeParameters)

مَعلمات وقت نقل بيانات FeatureView يجب تحديد هذه المَعلمات في وقت الاستيعاب، ولا يمكن تعديلها أثناء التنفيذ.
مكان كتابة النتائج في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
featureViewDestination

object (FeatureViewDestination)

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

FeatureViewDestination

إعدادات وجهة FeatureView في Earth Engine

تمثيل JSON 
{
  "name": string,
  "assetVersion": integer
}
الحقول
name

string

الحقل مطلوب. رقم تعريف مادة عرض FeatureView ينشئ الخادم اسم خريطة من المعرّف.
assetVersion

integer

إصدار مادة عرض FeatureView المطلوب إنشاؤه تُستخدَم لربط الإصدارات بأسماء مستعارة تتضمّن مواد عرض. في حال عدم ضبطها، سيتم استخدام القيمة 0.

BigQueryExportOptions

خيارات تصدير البيانات الجدولية إلى BigQuery

تمثيل JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of mutually exclusive fields.
}
الحقول
مكان كتابة البيانات في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
bigqueryDestination

object (BigQueryDestination)

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

BigQueryDestination

إعدادات وجهة في BigQuery

تمثيل JSON 
{
  "table": string,
  "overwrite": boolean,
  "append": boolean
}
الحقول
table

string

الحقل مطلوب. مرجع جدول الوجهة في BigQuery بالتنسيق التالي: "projectId.dataset_id.table_id".

إذا لم يكن المرجع موجودًا، سيتم إنشاء جدول جديد. ينطبق ذلك أيضًا إذا كانت المَعلمتان "إضافة إلى نهاية القيمة" و "الكتابة فوق القيمة" خاطئتين.

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

إذا كان المرجع متوفّرًا وكان المخطط غير متوافق مع المخطط الحالي، ستفشل المهمة أيضًا.
overwrite

boolean

تحدّد ما إذا كان سيتم استبدال بيانات الجدول إذا كان الجدول متوفّرًا حاليًا ويتضمّن مخططًا متوافقًا.

لا يمكن أن تكون المَعلمتان overwrite وappend true في الوقت نفسه.
append

boolean

تحدّد هذه السمة ما إذا كان يجب إلحاق بيانات الجدول إذا كان الجدول متوفّرًا حاليًا ويتضمّن مخططًا متوافقًا.

لا يمكن أن تكون المَعلمتان overwrite وappend true في الوقت نفسه.