واجهة برمجة تطبيقات واجهة مستخدِم Earth Engine

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

مرحبًا بالجميع!

يمثّل هذا المثال واجهة مستخدم بسيطة لزرّ معروض في وحدة التحكّم. يؤدي النقر على الزر إلى طباعة "مرحبًا، يا عالم!" في وحدة التحكّم:

محرِّر الرموز البرمجية (JavaScript)

// Make a button widget.
var button = ui.Button('Click me!');

// Set a callback function to run when the
// button is clicked.
button.onClick(function() {
  print('Hello, world!');
});

// Display the button in the console.
print(button);

لاحظ أنّه أولاً، يتم إنشاء الزر باستخدام وسيطة واحدة: تصنيفه. بعد ذلك، يتم استدعاء الدالة onClick() للزر. وسيطة دالة onClick() هي دالة أخرى سيتم تنفيذها عند النقر على الزر. تُعرف آلية الدالة التي سيتمّ استدعاؤها (دالة "ردّ اتصال") عند حدوث حدث باسم "معالج الحدث"، ويتم استخدامها على نطاق واسع في مكتبة واجهة المستخدم. في هذا المثال، عند النقر على الزر، تطبع الدالة "مرحبًا، يا عالم!" في وحدة التحكّم.

قابلية التغيير

يُرجى العلم أنّه على عكس العناصر في مساحة الاسم ee.*، تكون العناصر في مساحة الاسم ui.* قابلة للتغيير. وبالتالي، لا تحتاج إلى إعادة تعيين الكائن إلى متغيّر في كل مرة تستدعي فيها دالة مثيل على الكائن. سيؤدي استدعاء الدالة ببساطة إلى تغيير التطبيق المصغّر. يؤدي إلحاق الرمز البرمجي التالي بالمثال السابق إلى تسجيل طلب استدعاء آخر لحدث النقر على الزر:

محرِّر الرموز البرمجية (JavaScript)

// Set another callback function on the button.
button.onClick(function() {
  print('Oh, yeah!');
});

انسخ هذا الرمز إلى نهاية المثال السابق وانقر على تشغيل. الآن، عند النقر على الزر، يتم طباعة كلتا الرسالتَين في وحدة التحكّم.

استخدِم صفحات واجهة المستخدم للاطّلاع على مزيد من المعلومات عن إنشاء واجهات مستخدم للنصوص البرمجية في Earth Engine. تقدّم صفحة التطبيقات المصغّرة جولة مرئية وتصف وظائف التطبيقات المصغّرة الأساسية في حزمة ui. توضِّح صفحة "اللوحات والتنسيقات" حاويات وتنسيقات المستوى الأعلى التي يمكنك استخدامها لتنظيم التطبيقات المصغّرة وترتيبها. تحتوي صفحة "الأحداث" على تفاصيل حول ضبط سلوك التطبيقات المصغّرة وتفاعلها في واجهة المستخدم.