إشعار: يجب إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل 15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Method: projects.table.import

لاستيراد جدول

طلب HTTP

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

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

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

المعلمات

المعلمات
`project`	`string` معرّف المشروع أو رقم المشروع على Google Cloud Platform الذي يجب التعامل معه كمستهلك الخدمة لهذا الطلب. التنسيق هو `projects/{project-id}`. يتطلب التفويض إذن IAM التالي على المورد المحدّد `project`: `earthengine.assets.create`

project

string

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

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

earthengine.assets.create

نص الطلب

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

تمثيل JSON
{ "tableManifest": { object (`TableManifest`) }, "description": string, "overwrite": boolean, "requestId": string }

الحقول
`tableManifest`	`object (TableManifest)` ملف بيان الجدول
`description`	`string` اسم المهمة الذي يمكن لشخص عادي قراءته
`overwrite`	`boolean` ما إذا كان سيتم السماح باستبدال مادة عرض حالية.
`requestId`	`string` سلسلة فريدة تُستخدَم لرصد الطلبات المكرّرة إذا قدّم المستخدم نفسه أكثر من طلب واحد باستخدام `requestId` غير فارغ نفسه، قد يبدأ أحد هذه الطلبات فقط عملية طويلة الأمد بنجاح. يمكن أن يحتوي `requestId` على الأحرف a..z أو A..Z أو 0-9 أو "-". يمكن أن يتألّف `requestId` من 60 حرفًا كحدّ أقصى.

نص الاستجابة

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

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

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

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

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

TableManifest

يصف هذا القسم كيفية إنشاء خدمة EarthEngine لجدول من مجموعة من الملفات.

تمثيل JSON

تمثيل JSON
{ "name": string, "properties": { object }, "uriPrefix": string, "sources": [ { object (`TableSource`) } ], "startTime": string, "endTime": string, "csvColumnDataTypeOverrides": { string: enum (`CsvColumnDataType`), ... }, "columnDataTypeOverrides": { string: enum (`ColumnDataType`), ... }, "memo": string }

{
  "name": string,
  "properties": {
    object
  },
  "uriPrefix": string,
  "sources": [
    {
      object (TableSource)
    }
  ],
  "startTime": string,
  "endTime": string,
  "csvColumnDataTypeOverrides": {
    string: enum (CsvColumnDataType),
    ...
  },
  "columnDataTypeOverrides": {
    string: enum (ColumnDataType),
    ...
  },
  "memo": string
}

الحقول
`name`	`string` اسم مادة العرض التي سيتم إنشاؤها. يكون `name` بالتنسيق "projects//assets/*" (مثل "projects/earthengine-legacy/assets/users//"). تندرج جميع مواد العرض التي يملكها المستخدمون ضمن المشروع "earthengine-legacy" (مثل "projects/earthengine-legacy/assets/users/foo/bar"). تندرج جميع مواد العرض الأخرى ضمن المشروع "earthengine-public" (مثل "projects/earthengine-public/assets/LANDSAT").
`properties`	`object (Struct format)` خصائص إضافية لمادة العرض تم إيقاف اسمَي السمتَين "system:time_start" و "system:time_end" نهائيًا. استخدِم الحقلين `startTime` و`endTime` بدلاً من ذلك.
`uriPrefix`	`string` البادئة الاختيارية التي يتمّ وضعها قبل جميع `uri` التي تمّ تحديدها في هذا البيان
`sources[]`	`object (TableSource)` المصادر التي تتألف منها هذه الجداول
`startTime`	`string (Timestamp format)` الطابع الزمني المرتبط بمادة العرض، إن توفّر، مثل الوقت الذي تم فيه التقاط صورة من الأقمار الصناعية بالنسبة إلى مواد العرض التي تتوافق مع فاصل زمني، مثل متوسط القيم على مدار شهر أو عام، يتوافق الطابع الزمني مع بداية هذا الفاصل. يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: `"2014-10-02T15:01:23Z"` أو `"2014-10-02T15:01:23.045123456Z"` أو `"2014-10-02T15:01:23+05:30"`
`endTime`	`string (Timestamp format)` بالنسبة إلى مواد العرض التي تتوافق مع فاصل زمني، مثل متوسط القيم على مدار شهر أو سنة، يتوافق الطابع الزمني مع نهاية هذا الفاصل (حصري). يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: `"2014-10-02T15:01:23Z"` أو `"2014-10-02T15:01:23.045123456Z"` أو `"2014-10-02T15:01:23+05:30"`
`csvColumnDataTypeOverrides (deprecated)`	`map (key: string, value: enum (CsvColumnDataType))` تم إيقاف هذا العنصر نهائيًا. استخدِم columnDataTypeOverrides بدلاً من ذلك. عنصر يحتوي على قائمة بأزواج `"key": value` مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`columnDataTypeOverrides`	`map (key: string, value: enum (ColumnDataType))` تعيين من اسم العمود إلى النوع المطلوب استخدامه لذلك العمود سيتم استنتاج نوع الأعمدة غير المحدّدة هنا، مثل أن تصبح أعمدة الأرقام أرقامًا وأعمدة WKT هندسة، وما إلى ذلك. عنصر يحتوي على قائمة بأزواج `"key": value` مثال: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`memo`	`string` حقل بتنسيق حر لتخزين ملاحظات المستخدم لا يتم استخدامها في نقل البيانات.

TableSource

ملف جدول

تمثيل JSON
{ "uris": [ string ], "charset": string, "maxErrorMeters": number, "maxVertices": integer, "crs": string, "geodesic": boolean, "primaryGeometryColumn": string, "xColumn": string, "yColumn": string, "dateFormat": string, "csvDelimiter": string, "csvQualifier": string }