الوصول إلى Earth Engine

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

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

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

• تم تفعيل Earth Engine API،
• مسجَّلة للاستخدام التجاري أو غير التجاري
• يمنحك (أو يمنح المستخدم) الأدوار والأذونات الصحيحة.

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

earthengine create folder projects/my-project/assets/

تحديد مشروع

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

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

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

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

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

تطبيقات Earth Engine

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

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

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

واجهة برمجة تطبيقات REST

لربط الطلبات التي يتم إرسالها إلى واجهة 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 (menu) واختيار واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد. (اختَر المشروع إذا طُلب منك ذلك).

لإنشاء معرّف عميل جديد للمشروع، انقر على + إنشاء بيانات اعتماد > معرّف عميل 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 من حسابك.

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

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

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

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

مواد العرض

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

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

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

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

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

نصوص Code Editor البرمجية

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

تطبيقات Earth Engine

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

مراجع "الحصول على الرابط"

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

ضبط إذن الوصول غير التجاري

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

التحقّق

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

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

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

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

ضبط إذن الوصول التجاري

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

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

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

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

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

  • يمكنك أيضًا الوصول إلى صفحة "إدارة الخطط" مباشرةً لحساب فوترة باتّباع الخطوات التالية:

    https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID
    

  • يؤدي اختيار خطة "محدودة" إلى منع حساب الفوترة من تكبُّد أي رسوم اشتراك أخرى في منصة Earth Engine بعد دورة الفوترة الحالية.

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

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

• إيقاف الرسوم مقابل مساحة التخزين

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