إدارة مواد العرض

مواد عرض Earth Engine هي بيانات جغرافية مكانية مملوكة للمشروع ويتم تخزينها ضمن ال منصّة. يمكنك تحميل بياناتك الخاصة وتخزين البيانات الناتجة من تحليلات Earth Engine كمواد عرض.

أنواع مواد العرض

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

أنواع مواد العرض
Image صورة نقطية، وهي تمثيل للبيانات الجغرافية يستند إلى شبكة حيث تُحتوي كل خلية في الشبكة على قيمة تتوافق مع موقع جغرافي محدّد على سطح الأرض
ImageCollection مجموعة من الصور النقطية ذات الصلة التي تشكّل فسيفساء أو سلسلة زمنية وهو يشبه المجلد من الناحية الوظيفية، ولكن يمكن استيراده إلى Earth Engine كعنصر ee.ImageCollection يتضمّن مجموعة من الطرق للفلترة والتحليل.
Table هيكل بيانات جدولي يتألّف من عناصر متّجه (الصفوف)، يحتوي كلّ منها على سلسلة من المواقع (الأعمدة). يتم تمثيله بالكائن ee.FeatureCollection الذي يتضمّن مجموعة من الطرق للفلترة والتحليل.
Classifier نموذج تعلُّم آلة تم تدريبه في Earth Engine يتم تمثيله بالكائن ee.Classifier الذي يتضمّن مجموعة من methods للتطبيق والتحليل.
FeatureView عرض مرئي لجدول لاستخدامه في تطبيقات Earth Engine
Folder حاوية لمواد العرض والمجلدات الإضافية للمساعدة في التنظيم

تنظيم مواد العرض

يتم تنظيم مواد عرض Earth Engine في نظام هرمي من المجلدات والاقتباسات. وتتشابه البنية مع أنظمة الملفات الشائعة.

الجذر

تكون مواد العرض مملوكة لمشروع على Cloud. يحدّد اسم المشروع جذر ملف دلة مواد العرض. على سبيل المثال، جذر my-project هو projects/my-project/assets. جميع مواد العرض التي تنتمي إلى my-project موجودة في المجلد projects/my-project/assets أو في مجلد فرعي (أو ImageCollection) ضمنه.

الدليل

يستخدم Earth Engine بنية دليل شبيهة بالشجرة لتنظيم مواد العرض. يحتوي كل مشروع على Cloud على دليل جذر يمكن أن يحتوي على مواد عرض ومجلدات فردية. مجموعات الصور هي نوع خاص من مواد العرض مصمّمة على وجه التحديد لتضمين مجموعات من الصور ذات الصلة، مثل السلاسل الزمنية أو الصور المجمّعة. على عكس المجلدات، يمكن أن تحتوي مجموعات الصور على مواد عرض الصور فقط، ولا يمكن تداخل المجلدات أو المجموعات الأخرى فيها.

  • folder_dataprojects/my-project/assets/
    • folder folder-name/
      • photo image-name
      • اسم_الجدول view_comfy
      • القمر الصناعي featureview-name
      • bubble_chart اسم_المصنّف
      • photo_library imagecollection-name/
        • photo image-name-1
        • photo image-name-2

رقم تعريف مادة العرض

يستخدم Earth Engine أرقام تعريف مواد العرض للإشارة إلى البيانات في كلّ من النصوص البرمجية وعمليات سطر الأوامر. وتحدّد مواقع مواد العرض باستخدام الشُرط المائلة للأمام (/) كفاصل بين الأدلة. على سبيل المثال، يحدّد العنصر projects/my-project/assets/my-asset مادة عرض باسم "my-asset" في الجذر "my-project". في ما يلي مثال على استخدام هذا المعرّف للحصول على معلومات عن مادة العرض.

Python

print(ee.data.getAsset('projects/my-project/assets/my-asset'))

أداة تعديل الرموز

print(ee.Image('projects/my-project/assets/my-asset'))

سطر الأوامر

earthengine asset info projects/my-project/assets/my-asset

إنشاء مواد عرض

يمكنك إنشاء مجلدات ومجموعات صور ونقل الصور والجداول من الملفات المحلية أو الملفات في حزمة Google Cloud Storage. تشمل تنسيقات الصور المتوافقة GeoTIFF (العادي وCOG) وTFRecord. تشمل تنسيقات الجداول المتوافقة Shapefile وCSV. (يمكن أيضًا إنشاء مواد العرض من خلال تصدير نتيجة تحليل في Earth Engine باستخدام دوالّ الدُفعات Export.*.toAsset).

عميل Python

صورة

استخدِم الدالة ee.data.startIngestion لنقل الصور من Cloud Storage. اطّلِع على صفحة بيان الصور لمزيد من المعلومات حول ضبط عملية التحميل.

manifest = {
  'name': 'projects/my-project/assets/asset-name',
  'tilesets': [
    {
      'sources': [
        {
          'uris': [
            'gs://my-bucket/filename.tif'
          ]
        }
      ]
    }
  ]
}
ee.data.startIngestion(None, manifest)

جدول

استخدِم الدالة ee.data.startTableIngestion لنقل الجداول من Cloud Storage. اطّلِع على صفحة بيان الصور لمزيد من المعلومات حول ضبط عملية التحميل.

manifest = {
  'name': 'projects/my-project/assets/asset-name',
  'sources': [
    {
      'uris': [
        'gs://my-bucket/filename.csv'
      ]
    }
  ]
}
ee.data.startTableIngestion(None, manifest)

مجلد أو ImageCollection

استخدِم الدالة ee.data.createAsset لإنشاء مجلدات أو مجموعات صور فارغة.

ee.data.createAsset(
    {'type': 'FOLDER'}, # or 'IMAGE_COLLECTION'
    'projects/my-project/assets/asset-name'
)

أداة تعديل الرموز

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

سطر الأوامر

صورة أو جدول

earthengine upload image --asset_id=projects/my-project/assets/asset-name gs://my-bucket/filename.tif
earthengine upload table --asset_id=projects/my-project/assets/asset-name gs://my-bucket/filename.csv

مجلد أو ImageCollection

استخدِم الأمر earthengine create لإنشاء مجلدات أو مجموعات صور فارغة.

earthengine create folder projects/my-project/assets/folder-name
earthengine create collection projects/my-project/assets/collection-name

صورة خارجية

يمكن تسجيل ملفات GeoTIFF (COG) المحسَّنة للاستخدام على السحابة الإلكترونية التي تحمّلها إلى أحد حِزم Google Cloud Storage بصفتها مواد عرض صور خارجية واستخدامها مباشرةً في Earth Engine. راجِع المستندات المرجعية للحصول على مزيد من المعلومات عن مواد العرض المستندة إلى COG وإنشاء ملف بيان.

earthengine alpha upload external_image --manifest /tmp/foo.json

مواد عرض بطاقة بيانات المتجر

عميل Python

استخدِم الدالة ee.data.listAssets لإدراج مواد العرض في مجلد أو مجموعة (غير متكرّرة). اطّلِع على المستندات المرجعية للحصول على مزيد من المعلومات حول الفلترة وتقسيم الصفحات.

ee.data.listAssets('projects/my-project/assets')

يمكنك أيضًا الاطّلاع على ee.data.listImages و ee.data.listFeatures.

أداة تعديل الرموز

وسِّع المجلدات في "أداة إدارة مواد العرض" لعرض مواد العرض.

سطر الأوامر

استخدِم الأمر earthengine ls لإدراج مواد العرض في مجلد أو مجموعة (غير متكرّرة). اطّلِع على مستندات المراجع للحصول على مزيد من المعلومات عن الحدّ من عدد مواد العرض المُدرَجة ومقدار التفاصيل المعروضة.

earthengine ls projects/my-project/assets

ضبط أذونات مواد العرض

عميل Python

استخدِم الدالة ee.data.setAssetAcl لضبط الأذونات على مادة عرض.

asset_id = 'projects/my-project/assets/asset-name'
acl_update = {
    'owners': [
        'user:big_cheese@example.com',
        'user:el_jefe@example.com'
    ],
    'writers': [
        'user:romeo@example.com',
        'user:juliet@example.com'
    ],
    'readers': [
        'group:some-group@googlegroups.com',
        'domain:example.com',
        'serviceAccount:some-project-id@appspot.gserviceaccount.com'
    ],
    'all_users_can_read': False
}
ee.data.setAssetAcl(asset_id, acl_update)

أداة تعديل الرموز

في "أداة إدارة مواد العرض"، مرِّر مؤشر الماوس فوق مادة عرض وانقر على رمز المشاركة. في مربّع الحوار، أدخِل عنوان بريد إلكتروني أو نطاقًا لمشاركة مادة العرض معه، ثم اختَر مستوى الإذن الذي تريد منحه من القائمة المنسدلة. انقر على الزر منح الإذن بالوصول لتأكيد التغيير. ضَع علامة في المربّع "يمكن لأيّ مستخدم قراءة" لمنح أيّ كيان إذن القراءة. يمكنك أيضًا منح إذن الوصول إلى تطبيقات Earth Engine من مربّع الحوار عن طريق اختيار اسم التطبيق من القائمة المنسدلة (مواد العرض التي يملكها مشروع "محرر الرموز البرمجية" النشط).

سطر الأوامر

استخدِم الأمر earthengine acl set لضبط إذن الوصول للقراءة الخاص بأحد مواد العرض على public أو private.

earthengine acl set public projects/my-project/assets/asset-name

استخدِم الأمر earthengine acl ch لضبط أذونات فردية لقراءة وكتابة مواد العرض.

earthengine acl ch -u person@gmail.com:R projects/my-project/assets/asset-name

يمكنك الاطّلاع على صفحة مرجع سطر الأوامر لمزيد من التفاصيل.

التحقّق من أذونات مواد العرض

عميل Python

استخدِم الدالة ee.data.getAssetAcl لاسترداد قائمة التحكّم في الوصول إلى مادة عرض.

ee.data.getAssetAcl('projects/my-project/assets/asset-name')

أداة تعديل الرموز

في "أداة إدارة مواد العرض"، مرِّر مؤشر الماوس فوق مادة عرض وانقر على رمز المشاركة. يعرض مربّع الحوار قائمة بالعناوين الإلكترونية والنطاقات ومستويات الوصول الخاصة بها.

سطر الأوامر

استخدِم الأمر earthengine acl get لاسترداد قائمة التحكّم في الوصول إلى مادة عرض.

earthengine acl get projects/my-project/assets/asset-name

نسخ مواد العرض

عميل Python

استخدِم الدالة ee.data.copyAsset لنسخ مادة عرض.

ee.data.copyAsset('projects/my-project/assets/asset-name', 'projects/my-project/assets/asset-copy-name')

أداة تعديل الرموز

استخدِم برنامج Python أو أداة سطر الأوامر لنسخ مواد العرض.

سطر الأوامر

استخدِم الأمر earthengine cp لنسخ مادة عرض.

earthengine cp projects/my-project/assets/asset-name projects/my-project/assets/asset-copy-name

نقل مواد العرض أو إعادة تسميتها

عميل Python

استخدِم الدالة ee.data.renameAsset لنقل مادة عرض أو إعادة تسميتها.

ee.data.renameAsset('projects/my-project/assets/asset-name', 'projects/my-project/assets/new-asset-name')

أداة تعديل الرموز

نقل

ضمن "أداة إدارة مواد العرض"، اسحب مادة عرض إلى مجلد جديد.

إعادة التسمية

في "أداة إدارة مواد العرض"، مرِّر المؤشر فوق مادة عرض وانقر على رمز التعديل واكتب اسمًا جديدًا في حقل الإدخال القابل للتعديل.

سطر الأوامر

استخدِم الأمر earthengine mv لنقل مادة عرض أو إعادة تسميتها.

earthengine mv projects/my-project/assets/asset-name projects/my-project/assets/new-asset-name

حذف مواد العرض

عميل Python

استخدِم الدالة ee.data.deleteAsset لحذف مادة عرض.

ee.data.deleteAsset('projects/my-project/assets/asset-name')

أداة تعديل الرموز

انقر على مادة عرض لفتح صفحة مربّع حوار مادة العرض، ثم انقر على الزرّ حذف.

سطر الأوامر

استخدِم الأمر earthengine rm لحذف مادة عرض. اطّلِع على مرجع الدوالّ لمعرفة خيارات التشغيل التجريبي المتكرّر.

earthengine rm projects/my-project/assets/asset-name

الاطّلاع على البيانات الوصفية لمادة العرض

عميل Python

استخدِم الدالة ee.data.getAsset للحصول على البيانات الوصفية لمادة العرض.

ee.data.getAsset('projects/my-project/assets/asset-name')

أداة تعديل الرموز

انقر على مادة عرض لفتح صفحة مربّع حوار مادة العرض. اطّلِع على معلومات مادة العرض.

سطر الأوامر

استخدِم الأمر earthengine asset info للحصول على البيانات الوصفية لمادة العرض.

earthengine asset info projects/my-project/assets/asset-name

ضبط البيانات الوصفية لمادة العرض

يمكن ضبط البيانات الوصفية التالية لمادة العرض:

  • start_time
  • end_time

  • properties

عميل Python

استخدِم الدالة ee.data.updateAsset لتعديل البيانات الوصفية لمادة العرض.

asset_id = 'projects/my-project/assets/asset-name'
new_metadata = {
  'properties': {
    'name': 'value'
  },
  'start_time': '2024-10-02T15:01:24Z',
  'end_time': '2024-10-02T15:01:25Z',
}
update_these = ['start_time', 'end_time', 'properties']

ee.data.updateAsset(asset_id, new_metadata, update_these)

أداة تعديل الرموز

انقر على مادة عرض لفتح صفحة مربّع حوار مادة العرض، ثم فعِّل زر التبديل للتعديل في أعلى يسار الصفحة. يمكنك تعديل الوصف والسمات وتاريخَي البدء والانتهاء. أوقِف خيار التعديل لحفظ التغييرات.

سطر الأوامر

استخدِم الأمر earthengine asset set لتعديل البيانات الوصفية لمادة العرض. يمكنك الاطّلاع على المستندات المرجعية للحصول على مزيد من المعلومات.

earthengine asset set \
  --time_start 2024-10-02T15:01:24 \
  --time_end 2024-10-02T15:01:25 \
  --property 'name=value' \
  projects/my-project/assets/asset-name

التحقّق من حصة مواد العرض

يتم تطبيق الحصة على مستوى المشروع. اطّلِع على مزيد من المعلومات عن حصة مواد العرض في صفحة حدود الاستخدام والحصة.

عميل Python

استخدِم الدالة ee.data.getAssetRootQuota للحصول على مساحة التخزين المستخدَمة في جذر مادة العرض.

ee.data.getAssetRootQuota('projects/my-project/assets')

أداة تعديل الرموز

في "أداة إدارة مواد العرض"، مرِّر المؤشر فوق جذر مشروع وانقر على رمز data_usage. سيظهر مربّع حوار معلومات.

سطر الأوامر

استخدِم برنامج Python client أو "أداة تعديل الرموز" للاطّلاع على حصة مواد العرض.