الوصول إلى Earth Engine

تعمل منصة Earth Engine على Google Cloud وتتطلّب مشاريع على السحابة الإلكترونية للوصول إلى واجهة برمجة التطبيقات وإدارتها. يتم توجيه جميع طلبات Earth Engine (سواء من "أداة تعديل الرموز" أو مكتبات العملاء أو التطبيقات أو REST API) من خلال مشروع على السحابة الإلكترونية، ما يتيح التحكّم في الوصول وإدارة الموارد ومراقبة الاستخدام في Cloud Console.

الحصول على إذن الوصول إلى Earth Engine

لاستخدام Earth Engine، يجب أن يكون لديك إذن وصول إلى مشروع على السحابة الإلكترونية:

إنشاء مشروع

انتقِل إلى صفحة التسجيل لإنشاء مشروع على السحابة الإلكترونية جديد وتسجيله أو تسجيل مشروع حالي. بعد التسجيل، يتم تفعيل إذن الوصول إلى Earth Engine على الفور.

يمكن إدارة المشاريع التي تم إنشاؤها أثناء عملية التسجيل في Google Cloud Console. يمكنك تفعيل واجهة برمجة تطبيقات Earth Engine أو إيقافها من صفحة واجهة برمجة تطبيقات Earth Engine على Cloud Console.

الخطوات اليدوية (التي تتم تلقائيًا من خلال صفحة التسجيل)

إنشاء مشروع على السحابة الإلكترونية

أنشئ مشروعًا على Google Cloud إذا لم يسبق لك ذلك. يمكنك إجراء ذلك من صفحة المشاريع في Cloud Console أو النقر على الزر التالي:

إنشاء مشروع على السحابة الإلكترونية

تفعيل Earth Engine API

لتفعيل Earth Engine API لمشروعك، انقر على الزر التالي للانتقال إلى صفحة Earth Engine API:

تفعيل Earth Engine API

في صفحة Earth Engine API، تأكَّد من اختيار مشروعك، ثم انقر على الزر تفعيل.

تسجيل المشروع للاستخدام التجاري أو غير التجاري

عدِّل عنوان URL التالي لمشروعك، وانتقِل إلى الصفحة، وأكمِل عملية التسجيل.

https://code.earthengine.google.com/register?project=my-project

إنشاء مجلد مواد عرض (اختياري)

يمكنك إنشاء مجلد مواد عرض في Earth Engine مرتبط بمشروع على السحابة الإلكترونية لديك إذن بالوصول إليه باستخدام الأمر earthengine create folder باستخدام مسار كما هو موضّح هنا. على سبيل المثال:

earthengine create folder projects/my-project/assets/

يمكنك أيضًا إنشاء مجلد مواد عرض لمشروع في "أداة تعديل الرموز" من خلال إضافة المشروع في لوحة "مواد العرض".

ليس عليك إنشاء هذا المجلد إلا إذا كنت تخطط لتخزين مواد العرض في المشروع.

استخدام مشروع حالي

يُرجى التواصل مع فريق تكنولوجيا المعلومات في مؤسستك بشأن المشاريع الحالية على السحابة الإلكترونية التي تم إعدادها لاستخدام Earth Engine. تأكَّد من منح حساب Google الذي ستستخدمه للوصول إلى خدمات Earth Engine الأدوار والأذونات الصحيحة في المشروع.

تحديد مشروع

توضّح الأقسام التالية كيفية تحديد مشروع للواجهات المختلفة لخدمات Earth Engine.

مكتبات العملاء (Python وJavaScript)

تُستخدَم الدالة ee.Initialize() لتحديد مشروع لطلبات Earth Engine الواردة من مكتبات برامج Python وJavaScript. هناك عدة طرق لضبط مواصفات المشروع، ويمكنك الاطّلاع على صفحة المصادقة والإعداد لمزيد من التفاصيل.

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

انقر على رمز الملف الشخصي في أعلى يسار أداة تعديل الرموز واختَر "تغيير المشروع على السحابة الإلكترونية" من القائمة. اختَر مشروعًا من مربّع حوار الاختيار.

تطبيقات Earth Engine

عند نشر تطبيق Earth Engine، سيُطلب منك اختيار مشروع لتوجيه الطلبات من خلاله. اتّبِع التعليمات الواردة في مربّع حوار النشر.

أداة سطر الأوامر

لربط طلبات Earth Engine من أداة سطر الأوامر بمشروع على السحابة الإلكترونية، استخدِم المَعلمة --project في طلبك إلى earthengine أو استخدِم set_project لضبط مشروع تلقائي.

REST API

لربط طلبات REST API بمشروع على السحابة الإلكترونية، يجب إصدار طلبات HTTP مصادَق عليها تتم معالجة المصادقة فيها من خلال oauth2. في بيئة محلية، يمكنك استخدام الأمر gcloud. يمكنك أيضًا استخدام حساب خدمة مرتبط بمشروع على السحابة الإلكترونية. يمكنك الاطّلاع على دليل البدء السريع لواجهة برمجة التطبيقات REST API للحصول على مثال على استخدام google.oath.service_account.Credentials.from_service_account_file() للمصادقة باستخدام حساب خدمة.

ضبط إذن الوصول إلى المشروع

توضّح الأقسام التالية كيفية ضبط المشاريع التي تم تفعيل Earth Engine فيها ليستخدمها أفراد وحسابات خدمة آخرون.

حسابات الخدمة

تحصل حسابات الخدمة تلقائيًا على إذن الوصول بعد تسجيل مشروعها الرئيسي وتفعيل Earth Engine API. ويجب أيضًا أن يكون لديهم الأذونات الصحيحة ضمن المشروع. يمكن ضبط أي عدد من حسابات الخدمة في مشروع لاستخدام Earth Engine. يُرجى الانتقال إلى صفحة حسابات الخدمة لمزيد من المعلومات حول استخدام حسابات الخدمة مع Earth Engine.

حسابات Google

تستخدم المشاريع على السحابة الإلكترونية Cloud IAM لإدارة الأدوار والأذونات. لكي يتمكّن المستخدمون الآخرون من الوصول إلى Earth Engine من خلال مشروعك، عليك استخدام Cloud Console لمنحهم الأدوار والأذونات الصحيحة.

معرِّف عميل OAuth 2.0

قد تحتاج إلى إنشاء معرّف عميل OAuth 2.0 من مشروع، على سبيل المثال لإنشاء تطبيق يمرّر بيانات اعتماد المستخدم إلى Earth Engine. يمكنك إدارة بيانات الاعتماد لمشروعك على السحابة الإلكترونية من خلال الانتقال إلى قائمة Cloud Console () واختيار واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد. (اختَر المشروع إذا طُلب منك ذلك).

لإنشاء معرّف عميل جديد للمشروع، انقر على + إنشاء بيانات اعتماد > معرّف عميل OAuth > تطبيق ويب.

في إعدادات تطبيق الويب:

  • حدِّد مصادر JavaScript المعتمَدة، على سبيل المثال:
http://localhost:8080
https://foo-ee-project.appspot.com
  • حدِّد معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، على سبيل المثال:
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

مزيد من المعلومات حول مصادقة المستخدمين باستخدام OAuth

السيناريوهات الشائعة

أنا أدرِّس صفًا تعليميًا...

رائع! إذا سجّلت مشروعًا غير تجاري، لن تحتاج إلى ضبط إعدادات الفوترة. بعد ذلك، يمكنك إضافة طلابك إلى المشروع.

أنا جزء من فريق عمليات/مؤسسة تجارية...

رائع! يمكنك تسجيل مشروع للاستخدام التجاري وإضافة المتعاونين إليه. يُرجى أيضًا الانتباه إلى الحدّ الأقصى لعدد المقاعد في اشتراك Earth Engine الذي تختاره.

حذف بيانات Earth Engine

الحذف على مستوى الحساب

الحذف على مستوى الحساب: سيؤدي هذا الإجراء إلى إزالة جميع بيانات Earth Engine من حسابك.

إذا كان حسابك جزءًا من مؤسسة Google Workspace، يتحكّم المشرف في بيانات حسابك. عندما يحذف مشرف حسابًا على Google، يتم محو جميع بيانات Earth Engine المرتبطة به في غضون 30 يومًا تقريبًا.

لا يمكن لفريق Earth Engine استرداد البيانات بعد حذفها.

المشاريع على السحابة الإلكترونية

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

مواد العرض

أبسط طريقة لحذف مواد العرض هي استخدام علامة التبويب "مواد العرض" في "أداة تعديل الرموز" لعرض مواد عرض Earth Engine وحذفها يدويًا.

لحذف مادة عرض آليًا باستخدام رقم التعريف projects/{project-id}/assets/{asset-id} (مثلاً، projects/my-project/assets/my-asset):

برنامج Python

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

عميل JavaScript

يُرجى العِلم أنّ وضع الحماية الآمن في "أداة تعديل الرموز" يمنع هذا الطلب من العمل في تلك البيئة.

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

أداة سطر الأوامر

استخدِم الأمر rm:

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

النصوص البرمجية في "أداة تعديل الرموز"

لحذف نصوص "أداة تعديل الرموز" في Earth Engine، اتّبِع الخطوات التالية:

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

من علامة التبويب "النصوص البرمجية" في "أداة تعديل الرموز"، اختَر نصًا برمجيًا أو مستودعًا واحذفه. بعد وضع علامة على مستودع بأنّه محذوف، يصبح غير قابل للاسترداد في غضون 30 يومًا.

استخدام Git

يمكن للمستخدمين المتقدّمين استخدام Git لإدارة نصوصهم البرمجية. يمكنك الاطّلاع على https://earthengine.googlesource.com/ لإدراج المستودعات التي يمكنك عرضها.

تطبيقات Earth Engine

لحذف تطبيقات Earth Engine، استخدِم زر "التطبيقات" في "أداة تعديل الرموز" لإدارة تطبيقاتك.

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

ضبط إعدادات الوصول غير التجاري

لإعداد إمكانية الوصول غير التجاري (غير المدفوع) إلى Earth Engine لمشروعك، عليك ملء استبيان التسجيل في وحدة تحكّم Cloud لتأكيد أهلية مشروعك.

التحقق

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

اعتبارًا من 26 سبتمبر 2025، يجب أن تكون جميع المشاريع غير التجارية قد ملأت الاستبيان في وحدة تحكّم Cloud. ننصحك بإكمال عملية التحقّق في أقرب وقت ممكن. في حال عدم اتّخاذ الإجراءات قبل 26 سبتمبر 2025، سيتم إيقاف إمكانية وصول مشروعك إلى Earth Engine مؤقتًا إلى حين إكمال عملية إثبات الهوية.

إعادة التأكّد

يجب إعادة تأكيد جميع المشاريع التي لديها إذن وصول غير تجاري بشكل دوري.

ضبط إعدادات الوصول التجاري

لإعداد إمكانية الوصول التجاري (المدفوع) إلى Earth Engine لمشروعك، عليك ضبط المشروع باستخدام صفحة التسجيل واختيار خطة في حساب الفوترة.

إنهاء إمكانية الوصول التجاري

إذا كنت عميلاً مباشرًا في Earth Engine وأردت التوقف عن استخدام Earth Engine في سياق مدفوع، يجب إجراء عدة تغييرات لإيقاف تحصيل الرسوم:

  • إيقاف رسوم الاشتراك

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

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID
      
    • يؤدي اختيار الخطة "المحدودة" إلى إيقاف حساب الفوترة عن تحمُّل أي رسوم اشتراك أخرى في منصة Earth Engine بعد دورة الفوترة الحالية.

  • إيقاف رسوم الحوسبة

    • لتجنُّب تحصيل رسوم جديدة مرتبطة بالحوسبة (وقت EECU)، عليك إيقاف Earth Engine API في مشاريعك على السحابة الإلكترونية. يُرجى العِلم أنّ هذا الإجراء لا يؤدي إلى إنهاء الطلبات قيد التنفيذ أو حذف العناصر المخزَّنة، لذا قد يستمر تحصيل رسوم Earth Engine منك حتى في حال إيقاف واجهة برمجة التطبيقات.
    • يمكنك الاطّلاع على مساعدة وحدة تحكّم واجهة برمجة التطبيقات للحصول على معلومات حول إيقاف واجهات برمجة التطبيقات.
  • إيقاف رسوم التخزين

    • تستمر مواد عرض Earth Engine المخزَّنة في زيادة التكاليف حتى في حال إيقاف واجهة برمجة التطبيقات. يؤدي حذف مواد العرض إلى منعك من تحمُّل رسوم تخزين إضافية في EE.