يعمل Earth Engine على Google Cloud ويتطلّب مشاريع Cloud للوصول إلى واجهة برمجة التطبيقات وإدارتها. يتم توجيه جميع طلبات Earth Engine (سواء من "محرر الرموز" أو مكتبات العميل أو التطبيقات أو واجهة برمجة التطبيقات REST) من خلال مشروع على Cloud، ما يتيح التحكّم في الوصول وإدارة الموارد ومراقبة الاستخدام في Cloud Console.
الحصول على إذن الوصول إلى Earth Engine
لاستخدام Earth Engine، ستحتاج إلى إذن الوصول إلى مشروع على Cloud يستوفي الشروط التالية:
- تم تفعيل واجهة برمجة التطبيقات Earth Engine API
- أن يكون مسجَّلاً للاستخدام التجاري أو غير التجاري
- يمنحك (أو المستخدم) الأدوار والأذونات الصحيحة.
إنشاء مشروع
يُرجى الانتقال إلى صفحة التسجيل لإنشاء مشروع جديد في Cloud وتسجيله أو تسجيل مشروع حالي.
يمكن إدارة المشاريع التي تم إنشاؤها أثناء عملية التسجيل في Google Cloud Console. يمكنك تفعيل واجهة برمجة تطبيقات Earth Engine أو إيقافها من صفحة واجهة برمجة تطبيقات Earth Engine في Cloud Console.
الخطوات اليدوية (تُنفَّذ تلقائيًا من خلال صفحة التسجيل)
إنشاء مشروع على Cloud
أنشئ مشروعًا على Google Cloud إذا لم يسبق لك ذلك. يمكنك إجراء ذلك من صفحة المشاريع في Cloud Console أو النقر على الزر التالي:
إنشاء مشروع على Cloudتفعيل واجهة برمجة التطبيقات 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 مرتبط بمشروع
على Cloud يمكنك الوصول إليه باستخدام الأمر
earthengine create folder
باستخدام مسار كما هو موضّح
هنا.
على سبيل المثال:
earthengine create folder projects/my-project/assets/يمكنك أيضًا إنشاء مجلد مواد عرض لمشروع في "محرِّر الرموز البرمجية" عن طريق إضافة المشروع في لوحة "مواد العرض".
لست بحاجة إلى إنشاء هذا المجلد ما لم تكن تخطّط لتخزين مواد العرض في المشروع.
استخدام مشروع حالي
تحقَّق من موظفي تكنولوجيا المعلومات في مؤسستك بشأن مشاريع Cloud الحالية التي تم إعدادها لاستخدام Earth Engine. تأكَّد من منح حساب Google الذي ستستخدمه للوصول إلى خدمات Earth Engine الأدوار والامتيازات الصحيحة في المشروع.
تحديد مشروع
توضّح الأقسام التالية كيفية تحديد مشروع للواجهات المختلفة التي تؤدي إلى خدمات Earth Engine.
مكتبات العملاء (Python وJavaScript)
تُستخدَم الدالة ee.Initialize() لتحديد مشروع لطلبات Earth Engine
المنبثقة من مكتبتَي Python و
JavaScript العميلتَين. هناك عدة طرق لضبط مواصفات المشروع، راجِع صفحة
المصادقة والإعداد للحصول على مزيد من التفاصيل.
أداة تعديل الرموز
انقر على رمز الملف الشخصي في أعلى يسار محرِّر الرموز البرمجية واختَر "تغيير مشروع السحابة الإلكترونية" من القائمة. اختَر مشروعًا من مربّع الحوار للاختيار.
تطبيقات Earth Engine
عند نشر تطبيق Earth Engine، سيُطلب منك اختيار مشروع لتوجيه الطلبات من خلاله. اتّبِع التعليمات الواردة في مربّع diálogo الحوار الخاص بالنشر.
أداة سطر الأوامر
لربط طلبات Earth Engine من أداة سطر الأوامر بأحد مشاريع
Cloud، استخدِم المَعلمة --project في طلبك إلى earthengine أو
استخدِم set_project لضبط مشروع تلقائي.
واجهة برمجة تطبيقات REST
لربط طلبات البيانات من واجهة برمجة التطبيقات REST API بمشروع على Cloud، عليك إصدار طلبات HTTP تمت مصادقتها وتتولى oauth2 معالجة المصادقة. في بيئة محلية،
يمكنك استخدام الأمر gcloud. يمكنك أيضًا استخدام حساب
خدمة مرتبط بمشروع على Cloud. اطّلِع على التشغيل السريع لواجهة برمجة التطبيقات 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 من خلال الانتقال إلى قائمة 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 استرداد البيانات بعد حذفها.
المشاريع على السحابة الإلكترونية
عند حذف مشروع على Cloud، يؤدي ذلك إلى حذف بيانات 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 وأردت التوقف عن استخدام Earth Engine في سياق مدفوع، هناك عدة تغييرات مطلوبة للتوقف عن تحمُّل الرسوم:
إيقاف رسوم الاشتراك
- لإيقاف اشتراك Earth Engine في حساب الفوترة، عليك استخدام صفحة "إدارة الخطط" (التي يمكن الوصول إليها من قائمة المستخدمين المُسدلة في أعلى يسار "محرر الرموز" عند استخدام مشروع Cloud مسجَّل مرتبط بحساب الفوترة هذا).
يمكنك أيضًا الوصول إلى صفحة "إدارة الخطط" مباشرةً لحساب ملف شخصي للدفع:
https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_IDيؤدي اختيار الخطة "محدودة" إلى إيقاف حساب الفوترة عن تحمُّل أي رسوم إضافية مقابل اشتراك منصة Earth Engine بعد دورة الفوترة الحالية.
إيقاف رسوم الحوسبة
- لمنع تحصيل رسوم جديدة مرتبطة بوحدة الحساب (وقت وحدة معالجة البيانات الإلكترونية)، أوقِف واجهة برمجة التطبيقات Earth Engine API في مشاريعك على Cloud. يُرجى العِلم أنّ هذا الإجراء لا يؤدي إلى إنهاء الطلبات الجارية أو حذف العناصر المخزّنة، لذا قد تظلّ تدفع رسوم Earth Engine حتى مع إيقاف واجهة برمجة التطبيقات.
- اطّلِع على help (مساعدة) وحدة تحكّم واجهات برمجة التطبيقات للحصول على معلومات عن إيقاف واجهات برمجة التطبيقات.
إيقاف رسوم مساحة التخزين
- تستمرّ مواد عرض Earth Engine المخزّنة في زيادة التكاليف حتى إذا كانت واجهة برمجة التطبيقات متوقفة. يؤدي حذف مواد العرض إلى إيقاف تحمُّلك لمزيد من رسوم مساحة التخزين في EE.