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}.

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

  • earthengine.exports.create

نص الطلب

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

تمثيل JSON 
{
  "expression": {
    object (Expression)
  },
  "description": string,
  "selectors": [
    string
  ],
  "requestId": string,
  "maxErrorMeters": number,
  "maxVertices": integer,
  "workloadTag": string,
  "priority": integer,

  // Union field export_options can be only one of the following:
  "fileExportOptions": {
    object (TableFileExportOptions)
  },
  "assetExportOptions": {
    object (TableAssetExportOptions)
  },
  "featureViewExportOptions": {
    object (FeatureViewAssetExportOptions)
  },
  "bigqueryExportOptions": {
    object (BigQueryExportOptions)
  }
  // End of list of possible types for union field export_options.
}
الحقول
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 إذا لم يتم ضبطها.
حقل الربط export_options خيارات تصف مكان تخزين النتائج وكيفية تخزينها يمكن أن يكون export_options واحدًا فقط مما يلي:
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),

  // 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 (TableFileFormat)

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

object (DriveDestination)

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

object (CloudStorageDestination)

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

TableAssetExportOptions

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

تمثيل JSON 
{

  // Union field destination can be only one of the following:
  "earthEngineDestination": {
    object (EarthEngineDestination)
  }
  // End of list of possible types for union field destination.
}
الحقول
حقل الربط destination مكان كتابة النتائج يمكن أن يكون destination واحدًا فقط مما يلي:
earthEngineDestination

object (EarthEngineDestination)

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

FeatureViewAssetExportOptions

خيارات حفظ الجداول أو مجموعات العناصر كخرائط FeatureView

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

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

object (FeatureViewIngestionTimeParameters)

مَعلمات وقت نقل البيانات إلى FeatureView يجب تحديد هذه المَعلمات في وقت نقل البيانات ولا يمكن تعديلها أثناء التنقل.
حقل الربط destination مكان كتابة النتائج يمكن أن يكون destination واحدًا فقط مما يلي:
featureViewDestination

object (FeatureViewDestination)

في حال تحديده، يتم ضبط التصدير إلى "مخطّطات الاطِّلاع على الكيانات".

FeatureViewDestination

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

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

string

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

integer

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

BigQueryExportOptions

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

تمثيل JSON 
{

  // Union field destination can be only one of the following:
  "bigqueryDestination": {
    object (BigQueryDestination)
  }
  // End of list of possible types for union field destination.
}
الحقول
حقل الربط destination مكان كتابة البيانات يمكن أن يكون destination واحدًا فقط مما يلي:
bigqueryDestination

object (BigQueryDestination)

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

BigQueryDestination

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

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

string

مطلوب. إشارة إلى جدول الوجهة في BigQuery بالشكل التالي: "projectId.dataset_id.table_id"

إذا لم يكن المورد المُشار إليه متوفّرًا، سيتم إنشاء جدول جديد. وينطبق ذلك أيضًا إذا كانت المَعلمتَان append وoverwrite خطأ.

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

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

boolean

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

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

boolean

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

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