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