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

مواد عرض 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/
      • photo image-name
      • view_comfy table-name
      • satellite featureview-name
      • bubble_chart classifier-name
      • 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 وTFRecord، ويمكن أيضًا تسجيل ملفات GeoTIFF المحسّنة للسحابة الإلكترونية (COGs) في Cloud Storage بدلاً من نقلها. تشمل تنسيقات الجداول المتوافقة 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) في حزمة Cloud Storage كأصول مستندة إلى COG (تُعرف باسم الصور الخارجية في واجهة برمجة التطبيقات) واستخدامها مباشرةً في Earth Engine. يُرجى الاطّلاع على دليل تسجيل COG لإنشاء بيان.

earthengine 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 أو "أداة تعديل الرموز" للتحقّق من حصة مواد العرض.