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

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

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

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

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

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

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

الجذر

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

الدليل

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

  • folder_dataprojects/my-project/assets/
    • folder folder-name/
      • صورة اسم_الصورة
      • view_comfy اسم_الجدول
      • satellite 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'))

Code Editor

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

سطر الأوامر

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

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

يمكنك إنشاء مجلدات وImageCollections واستيعاب الصور والجداول من الملفات المحلية أو الملفات في حزمة 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)

Folder أو ImageCollection

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

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

Code Editor

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

سطر الأوامر

صورة أو جدول

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

Folder أو ImageCollection

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

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

صورة خارجية

يمكن تسجيل ملفات Cloud-Optimized 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.

Code Editor

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

سطر الأوامر

استخدِم الأمر 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)

Code Editor

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

سطر الأوامر

استخدِم الأمر 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')

Code Editor

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

سطر الأوامر

استخدِم الأمر 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')

Code Editor

استخدِم برنامج 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')

Code Editor

نقل

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

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

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

سطر الأوامر

استخدِم الأمر 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')

Code Editor

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

سطر الأوامر

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

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

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

برنامج Python

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

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

Code Editor

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

سطر الأوامر

استخدِم الأمر 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)

Code Editor

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

سطر الأوامر

استخدِم الأمر 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')

Code Editor

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

سطر الأوامر

استخدِم عميل Python أو "أداة تعديل الرموز" للتحقّق من حصة مواد العرض.