مقدمة
تطبيقات Earth Engine هي واجهات مستخدم ديناميكية وقابلة للمشاركة لتحليلات Earth Engine. باستخدام التطبيقات، يمكن للخبراء استخدام عناصر واجهة مستخدم بسيطة لاستفادة من كتالوج بيانات Earth Engine وإمكاناته التحليلية، بحيث يمكن للخبراء وغير الخبراء استخدامها على حد سواء.
يمكن الوصول إلى التطبيقات المنشورة من Earth Engine من عنوان URL الخاص بالتطبيق الذي تم إنشاؤه في وقت النشر. لا يلزم توفُّر حساب على Earth Engine لعرض تطبيق منشور أو التفاعل معه. وتتوفّر أيضًا التطبيقات التي اختارها مطوّرها لعرضها في "معرض التطبيقات" الخاص بالمستخدم (مثل USERNAME.users.earthengine.app).
إنشاء تطبيقك
يمكن لتطبيقات Earth Engine الاستفادة من معظم الدوالّ نفسها المستخدَمة في "محرر الرموز"، مع بعض الاستثناءات. بالإضافة إلى ذلك، تم تصميم واجهة برمجة التطبيقات User Interface API مع وضع مطوّري التطبيقات في الاعتبار. إذا كنت مستخدِمًا جديدًا لواجهة برمجة التطبيقات User Interface API، يمكنك الاطّلاع على نظرة عامة على User Interface API.
نشر تطبيقك
لنشر تطبيق من "محرِّر الرموز"، عليك أولاً تحميل النص البرمجي الذي تريد تحويله إلى تطبيق، ثم فتح لوحة "إدارة التطبيقات" التي يمكنك الوصول إليها من خلال النقر على زر التطبيقات أعلى قسم النص البرمجي في "محرِّر الرموز".
بعد ذلك، انقر على الزر تطبيق جديد.
في مربّع الحوار، اختَر إذن وصول المحرِّر واسم التطبيق، ثم اختَر مشروعًا على Google Cloud وحدِّد
مكان رمز المصدر للتطبيق. يمكنك حصر إمكانية الوصول إلى هذا التطبيق في مجموعة معيّنة على Google
أو إبقاء إمكانية الوصول إليه علنية باستخدام الخيارات ضمن علامة التبويب "القيود". بالنسبة إلى التطبيقات التي يمكن للجميع
الوصول إليها، يمكنك أيضًا تقديم صورة معاينة مخصّصة للتطبيق بالإضافة إلى
وصف في علامة التبويب "المعرض". انقر على "عرض هذا التطبيق في معرض التطبيقات" إذا أردت
أن يظهر هذا التطبيق في معرض التطبيقات العلني المتاح على
USERNAME.users.earthengine.app. يمكنك اختياريًا تضمين شعار مخصّص في
أعلى يمين التطبيق من خلال تحميل صورة من اختيارك من علامة التبويب "الشعار".
إدارة تطبيقاتك
لإدارة تطبيق من "محرِّر الرموز البرمجية"، افتح لوحة "إدارة التطبيقات" بالنقر على زر التطبيقات أعلى قسم النص البرمجي في "محرِّر الرموز البرمجية". من هنا، يمكنك تعديل إعدادات تطبيقك أو حذفه.
التعاون مع الآخرين في التطبيقات التي يملكها المشروع
يمكنك تلقائيًا تعديل التطبيقات التي تنشرها باسم المستخدم الخاص بك فقط. يمكن التعاون في التطبيقات باستخدام التطبيقات التي يملكها المشروع. التطبيقات التي يملكها المشروع هي التطبيقات التي تمّ امتلاكها ونشرها ضمن مشروع على Cloud. ويمكن لأيّ مستخدم لديه دور إدارة الهوية وإمكانية الوصول (IAM) المتمثل في ناشر تطبيقات Earth Engine تعديل التطبيقات المنشورة ضمن مشروع Cloud وحذفها. مزيد من المعلومات حول أدوار إدارة الهوية وإمكانية الوصول في Earth Engine هنا
لتفعيل التطبيقات التي يملكها المشروع، اختَر الخيار مشروع على Cloud في
الخطوة "اختيار إذن الوصول إلى التعديل"، ثم اختَر مشروع Cloud الذي تريد استخدامه، ثم اختَر
مسار نشر التطبيق كالمعتاد. سيتم نشر التطبيق في النطاق
PROJECT-ID.projects.earthengine.app وسيكون قابلاً للتعديل من قِبل أي مستخدم لديه
دور "إدارة الهوية وإمكانية الوصول" لـ "ناشر تطبيقات Earth Engine" في مشروع Cloud.
للاطّلاع على تطبيقات مشروع على السحابة الإلكترونية، اضغط على الزر إضافة مشروع على السحابة الإلكترونية و اختَر المشروع على السحابة الإلكترونية.
لمشاركة مشروع Cloud مع الآخرين، اضغط على الزر مشاركة المشروع. سينقلك هذا الإجراء إلى صفحة إدارة الهوية وإمكانية الوصول في Cloud Console للمشروع حيث يمكنك منح المتعاونين دور "ناشر تطبيقات Earth Engine" في إدارة الهوية وإمكانية الوصول.
الأسئلة الشائعة
- كيف يمكنني إزالة تطبيق من "معرض التطبيقات"؟
- يتحكّم مربّع الاختيار "عرض هذا التطبيق" في صفحة إعدادات التطبيق في ما إذا كان التطبيق سيظهر في صفحة "التطبيقات المميّزة" أم لا. لا يمكن عرض التطبيقات التي توفّر إمكانية وصول محدودة.
- هل رمز Earth Engine مرئي؟
- نعم، لأي شخص يمكنه الوصول إلى التطبيق. على الرغم من أنّه لا يظهر بوضوح عند نشر تطبيقك، من السهل إلى حدٍ ما أن يطّلع أحد الأشخاص على JavaScript لتطبيقك من خلال مراقبة عدد زيارات الشبكة إلى متصفح الويب الخاص به. في Chrome، على سبيل المثال، سيظهر JavaScript من خلال الاطّلاع على لوحة "الشبكة" في "أدوات المطوّرين".
- ما هي بعض الأسباب المحتمَلة لخطأ "حدث خطأ أثناء تحميل بعض أجزاء الخريطة" في تطبيق منشور؟
- تأكَّد من مشاركة جميع مواد عرض الصور أو الجداول المستخدَمة في تطبيقك بشكل علني أو مع التطبيق. في مربّع حوار مشاركة مواد العرض، اختَر الخيار "يمكن لأي مستخدم قراءة" أو اختَر اسم التطبيق من القائمة المنسدلة. بالنسبة إلى التطبيقات المخصّصة لمجموعة على "مجموعات Google"، لن تؤدي مشاركة مادة عرض مع مجموعة "مجموعات Google" هذه إلى إتاحتها للتطبيق، بل يجب مشاركة مواد العرض مع التطبيق أو بشكل علني بدلاً من ذلك.
- لماذا تظهر لي صفحة "التطبيق غير جاهز بعد"؟
- بعد إنشاء تطبيق، قد يستغرق نشر المعلومات في النظام بعض الوقت. يتم عادةً حلّ هذه المشكلة في غضون بضع دقائق. في حال استمرار ظهور الخطأ، يُرجى التواصل معنا للحصول على المساعدة.
- لماذا تظهر الأشكال الهندسية التي رسمتها في تطبيقي؟
- يسهّل ذلك عرض الأشكال الهندسية المرجعية في تطبيقك، ويسمح لك بإنشاء تطبيقات يمكن للمستخدمين فيها تعديل الأشكال الهندسية. إذا كنت لا تريد عرض أشكال هندسية معيّنة أو تعديلها، يمكنك إخفاء طبقات الأشكال الهندسية الفردية أو قفلها لمنع المستخدمين من رؤيتها أو تعديلها قبل نشر تطبيقك. اطّلِع على مستندات أدوات الأشكال الهندسية لمعرفة المزيد من المعلومات.
- ما هي حصة التطبيق؟
- لمنع النصوص البرمجية الخاطئة أو التي تستهلك موارد كثيرة من التأثير سلبًا في مدى توفّر الخدمة، تفرض Earth Engine حصصًا لاستخدام التطبيقات على طلبات البحث المتزامنة. تعمل هذه الحصة بشكل مشابه للحصة لكل مستخدم في Earth Engine، باستثناء أنّ الحصة مرتبطة بالتطبيق، وليس بمستخدم معيّن.
- هل لكل تطبيق أُنشئه حصة خاصة به؟
- نعم، ترتبط حصة منفصلة بكل تطبيق. بالنسبة إلى التطبيقات القديمة التي تم إنشاؤها باستخدام مفتاح واجهة برمجة تطبيقات، تكون الحصة مرتبطة بمشروع Cloud الذي تنشئ منه مفتاح واجهة برمجة تطبيقات للتطبيق. في حال إنشاء مفاتيح واجهة برمجة تطبيقات متعددة من مشروع Cloud نفسه، ستتشارك مفاتيح واجهة برمجة التطبيقات جميعها حصة الاستخدام نفسها.
- لماذا يجب توفُّر حساب فوترة على Cloud؟ هل سيتم تحصيل رسوم منّي مقابل تطبيقاتي؟
- نستخدم Google Cloud Platform لتنفيذ مجموعة متنوعة من المهام التي تتمّ خلف الكواليس. لن يتم تحصيل رسوم منك مقابل إنشاء تطبيق Earth Engine. ومع ذلك، فإنّ Google Cloud Storage ليس مجانيًا، لذا إذا اخترت تصدير نتائج تحليلاتك إلى Google Cloud Storage، قد يتم تحصيل رسوم مرتبطة بذلك.
- كيف يمكنني فهم استخدام التطبيقات والحصة بشكل أفضل؟
-
في حال تجاوز الحصة، قد تُظهر Earth Engine أخطاء
HTTP 429: Too Many Requests. بشكل عام، تعالج مكتبة عملاء Earth Engine هذه الأخطاء، والتي تلفِّق الطلبات في فترة انتظار تصاعدية، وتعيد محاولة طلب البحث إلى أن تنجح. ستعيد مكتبة برمجة التطبيقات لمحرك Earth المحاولة خمس مرات.إذا أصبح تطبيقك رائجًا جدًا وتلقّى العديد من المستخدمين أخطاء تجاوز الحصة، ستظهر للمستخدمين رسالة تحذير، وقد تضطر خدمة Earth Engine إلى حظر الوصول إلى التطبيق (بشكل مؤقت).
للمساعدة في تجنُّب تلقّي أخطاء 429، ننصحك بتفعيل ميزة التخزين المؤقت لتطبيقك، مثل تخزين الإحصاءات المجمّعة القابلة للتخزين المؤقت كمواد عرض لجداول Earth Engine، بدلاً من احتسابها أثناء التشغيل.