قد تكون مواد عرض Earth Engine (مثل الصور والجداول) مواد عرض قديمة (أي غير مرتبطة بمشروع على السحابة الإلكترونية) أو مواد عرض مرتبطة بمشروع على Google Cloud. يوضّح هذا الدليل كيفية استخدام "أداة إدارة مواد العرض" لتحميل و/أو استخدام مواد العرض المرتبطة بمشروع Cloud.
Cloud Asset Manager
يحتوي Cloud Asset Manager على قسم مواد العرض على السحابة الإلكترونية وقسم مواد العرض القديمة وزر إضافة مشروع.
أصول السحابة الإلكترونية
يحتوي قسم "مواد العرض على السحابة الإلكترونية" على مواد عرض تنتمي إلى أي من مشاريع Google Cloud المثبّتة في "إدارة مواد العرض". يظهر هنا تلقائيًا "مشروع السحابة الإلكترونية" الذي تم اختياره لجلسة "محرّر التعليمات البرمجية" (كما هو موضّح في أعلى يسار "محرّر التعليمات البرمجية"). يمكن تثبيت مشاريع إضافية من خلال النقر على الزر إضافة مشروع واختيار مشروع في مربّع الحوار اختيار مشروع على السحابة الإلكترونية. سيتم عرض مواد العرض ضمن هذه المشاريع في لوحة zippy موسّعة في البداية، مع تصغير المجلدات المدمجة في البداية.
مواد العرض القديمة
مواد العرض القديمة هي مواد عرض مرتبطة بحسابك على Earth Engine قبل دمج Earth Engine مع السحابة الإلكترونية.
إضافة مشروع
سيؤدي النقر على الزر إضافة مشروع إلى فتح مربّع الحوار اختيار مشروع Cloud.
سيقدّم مربّع الحوار هذا قائمة منسدلة لاختيار مشروع على السحابة الإلكترونية، وسيتم عرض مواد عرض Earth Engine المتوفّرة في هذا المشروع. تظهر المشاريع التي سبق أن ثبّتها على أنّها مشاريع مفعّلة في Earth Engine. سيؤدي اختيار مشروع على السحابة الإلكترونية من القائمة المنسدلة والنقر على اختيار إلى تثبيت المشروع في قسم "مواد العرض على السحابة الإلكترونية" وعرض مواد العرض المتضمّنة في المشروع.
سيؤدي اختيار مشروع تم تثبيته إلى توفير خيار إلغاء تثبيت المشروع بدلاً من ذلك.
تحميل مواد العرض
حمِّل مواد العرض باستخدام الزر تحميل مواد العرض. سيتم تلقائيًا ربط مواد العرض التي تم تحميلها بالمشروع المحدّد في "محرّر الرموز". إذا أردت ربط الأصول الجديدة بمشروع مختلف، اختَر مشروعًا مختلفًا من خلال أداة اختيار المشاريع التي يوفّرها مربّع حوار التحميل.
إدارة مواد العرض
يمكن إدارة مواد العرض من خلال علامة التبويب إدارة مواد العرض في "أداة تعديل الرموز" أو من خلال سطر الأوامر أو مكتبة برامج (مثل ee.data.getAsset) أو من خلال REST API مباشرةً.
إدارة أذونات مواد العرض
لمنح مستخدمين آخرين إذن الوصول إلى مواد العرض الخاصة بك بغرض القراءة أو الكتابة أو التحكّم الإداري الكامل، يمكنك ضبط الأذونات على مادة العرض أو المشروع أو كليهما. يمكنك الاطّلاع على صفحة "التحكّم في الوصول" لمعرفة التفاصيل.
الوصول إلى مواد العرض
تكون مسارات مواد العرض بالتنسيق projects/${PROJECT_NAME}/assets/${ASSET_NAME}.
يتم استخدام هذه المسارات في أدوات إنشاء مكتبات البرامج، وعند إجراء عمليات التصدير من خلال إحدى مكتبات البرامج، وفي وقت الاستيعاب أو التحميل، وفي طلبات REST API.
مواد العرض المتاحة للجميع
يمكن الوصول إلى الصور في الكتالوج العام من مسارات مثل
projects/earthengine-public/assets/path/to/asset/asset-id. على سبيل المثال، إليك مشهدًا من Landsat:
projects/earthengine-public/assets/LANDSAT/LC08/C02/T1_RT/LC08_001004_20140609
يُرجى العِلم أنّ PROJECT_NAME في هذا المثال هو earthengine-public.
يمكن تمرير هذه المسارات مباشرةً إلى دوال الإنشاء، مثل Image أو ImageCollection أو FeatureCollection. يمكنك أيضًا تمرير مسارات مواد العرض إلى واجهة برمجة تطبيقات REST.
في ما يلي
مثال بسيط جدًا من دليل البدء السريع لواجهة REST.
الأصول الشخصية
للوصول إلى أحد عناصر Earth Engine المخزّنة في مشروع تملكه أو لديك إذن بعرضه،
اضبط قيمة PROJECT_NAME على رقم تعريف المشروع الذي يملك العنصر. على سبيل المثال:
projects/my-ee-enabled-project-id/assets/my-asset-id
في هذا المثال، my-ee-enabled-project-id هو اسم مشروع تم من خلاله تحميل مواد عرض أو إنشاؤها سابقًا. يمكنك الاطّلاع على صفحة المشاريع للحصول على مزيد من المعلومات حول كيفية تفعيل Earth Engine API في مشروع على السحابة الإلكترونية.
مواد العرض القديمة
مواد العرض القديمة هي مواد عرض مخزّنة في مجلدات قديمة users/ أو projects/. عند الوصول إلى مواد العرض هذه، يكون PROJECT_NAME
earthengine-legacy. على سبيل المثال:
projects/earthengine-legacy/assets/users/user-name/my-asset-id
الوصول إلى الصور في Cloud Storage
يمكنك الوصول إلى ملفات Cloud Optimized GeoTIFF (اختصارًا COG) مباشرةً من حزمة Cloud Storage باستخدام
ee.Image.loadGeoTIFF().
يمكنك أيضًا إنشاء مواد عرض Earth Engine مستندة إلى COG كما هو موضّح في مثال واجهة برمجة التطبيقات REST هذا.