أداة تعديل الرموز البرمجية في Earth Engine

يُعدّ "أداة تعديل الرموز" (EE) في Earth Engine على code.earthengine.google.com بيئة تطوير متكاملة (IDE) مستندة إلى الويب ومخصّصة لواجهة برمجة التطبيقات JavaScript في Earth Engine. تم تصميم ميزات "أداة تعديل الرموز" لتسهيل وتسريع عملية تطوير مسارات العمل الجغرافية المكانية المعقّدة. يحتوي "محرّر الرموز" على العناصر التالية (كما هو موضّح في الشكل 1):

  • أداة تعديل رموز JavaScript
  • عرض الخريطة لتصوّر مجموعات البيانات الجغرافية المكانية
  • المستندات المرجعية لواجهة برمجة التطبيقات (علامة التبويب "المستندات")
  • أداة "إدارة النصوص البرمجية" المستندة إلى Git (علامة التبويب "النصوص البرمجية")
  • نتائج وحدة التحكّم (علامة التبويب "وحدة التحكّم")
  • "إدارة المهام" (علامة التبويب "المهام") للتعامل مع الاستعلامات الطويلة الأمد
  • طلب بحث في خريطة تفاعلية (علامة التبويب "أداة الفحص")
  • البحث في أرشيف البيانات أو النصوص البرمجية المحفوظة
  • أدوات رسم الأشكال الهندسية

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

الشكل 1: مخطّط لمكوّنات "أداة تعديل الرموز البرمجية" في Earth Engine على code.earthengine.google.com.

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

محرِّر JavaScript

سيؤدي محرِّر JavaScript ما يلي:

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

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

مرجع واجهة برمجة التطبيقات (علامة التبويب "المستندات")

على يمين أداة تعديل الرموز، تظهر علامة التبويب المستندات التي تحتوي على مستندات JavaScript API الكاملة. يمكن البحث في المستندات وتصفّحها من علامة التبويب المستندات.

مدير النصوص البرمجية (علامة التبويب "النصوص البرمجية")

تظهر علامة التبويب النصوص البرمجية بجانب "مستندات واجهة برمجة التطبيقات" في اللوحة اليمنى من "أداة تعديل الرموز". يخزّن "مدير النصوص البرمجية" النصوص البرمجية الخاصة والمشترَكة ونصوص الأمثلة في مستودعات Git التي تستضيفها Google. يتم ترتيب المستودعات حسب مستوى الوصول، ويتم تخزين النصوص البرمجية الخاصة بك في مستودع تملكه في المجلد المالك: users/username/default. يمكنك وحدك الوصول إلى المستودعات في المجلد المالك، ما لم تشاركها مع مستخدم آخر. المستودعات في المجلد Writer هي مستودعات منحك مالكها إذن الوصول إليها للكتابة. يمكنك إضافة نصوص برمجية جديدة إلى المستودعات في مجلد الكاتب أو تعديل النصوص البرمجية الحالية أو تغيير إذن الوصول إليها (لا يمكنك إزالة مالكها). المستودعات في مجلد القارئ هي مستودعات منحك مالكها إذن الوصول إليها للقراءة. المجلد أمثلة هو مستودع خاص تديره Google ويحتوي على عيّنات من التعليمات البرمجية. يحتوي مجلد الأرشيف على مستودعات قديمة يمكنك الوصول إليها، ولكن لم ينقلها مالكها بعد من إصدار قديم من "أداة إدارة النصوص البرمجية". ابحث في النصوص البرمجية باستخدام شريط الفلتر في أعلى علامة التبويب النصوص البرمجية.

Script Manager

الشكل 2: أداة "إدارة النصوص البرمجية"

انقر على الزر لإنشاء مستودع جديد في المجلد المالك أو لإنشاء مجلدات وملفات داخل مستودع. يمكنك إعادة تسمية النصوص البرمجية باستخدام الرمز وحذفها باستخدام الرمز . يمكنك نقل البرامج النصية وتنظيمها في مجلدات باستخدام ميزة السحب والإفلات (الشكل 2). إذا سحبت نصًا برمجيًا إلى مستودع آخر، سيتم نسخه.

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

يمكن الوصول إلى المستودعات باستخدام Git، ما يتيح لك إدارة النصوص البرمجية وتعديلها خارج أداة تعديل الرموز أو مزامنتها مع نظام خارجي مثل GitHub (يمكنك الاطّلاع على مزيد من المعلومات حول Git من مستندات Git). انقر على رمز بجانب اسم المستودع للحصول على تعليمات حول استنساخ المستودع. يمكنك تصفّح المستودعات التي يمكنك الوصول إليها من خلال الانتقال إلى earthengine.googlesource.com (يتطلّب ذلك تسجيل الدخول باستخدام حساب Google Earth Engine). للحصول على تعليمات حول استخدام Git لاستعادة البرامج النصية أو المجلدات المحذوفة، أو لنقل مستودع إلى حساب آخر، يُرجى الاطّلاع على استرداد البرامج النصية ونقل المستودع.

وحدات النصوص البرمجية

من أفضل الممارسات كتابة رموز برمجية نموذجية قابلة لإعادة الاستخدام يمكن مشاركتها بين النصوص البرمجية بدون الحاجة إلى نسخ ولصق أجزاء كبيرة منها. لإتاحة التطوير النمطي، توفّر Earth Engine إمكانية مشاركة الرموز البرمجية بين البرامج النصية. على سبيل المثال، لنفترض أنّك تكتب دالة تنفّذ مجموعة مفيدة من العمليات. بدلاً من نسخ رمز الدالة إلى نص برمجي جديد، من الأسهل أن يحمّل النص البرمجي الجديد الدالة مباشرةً. لإتاحة استخدام دالة أو عنصر في نصوص برمجية أخرى، عليك إضافتهما إلى عنصر خاص يُسمى exports. لاستخدام الرمز في نص برمجي آخر، استخدِم الدالة require لتحميل عمليات التصدير من نص برمجي آخر. على سبيل المثال، لنفترض أنّك حدّدت الوحدة التالية في ملف باسم FooModule.js يقع في مجلد باسم Modules:

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

/**
 * The Foo module is a demonstration of script modules.
 * It contains a foo function that returns a greeting string.
 * It also contains a bar object representing the current date.
 * @module Modules/FooModule
 */

/**
 * Returns a greeting string.
 * @param {ee.String} arg The name to which the greeting should be addressed
 * @return {ee.String} The complete greeting.
 */
exports.foo = function(arg) {
  return 'Hello, ' + arg + '!  And a good day to you!';
};

/**
 * An ee.Date object containing the time at which the object was created.
 */
exports.bar = ee.Date(Date.now());

لاحظ استخدام الكلمة الرئيسية exports في شكل exports.objectToExport. يمكنك الاستفادة من هذا الوحدة في نص برمجي آخر باستخدام الدالة require. على سبيل المثال:

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

var Foo = require('users/username/default:Modules/FooModule.js');

print(Foo.doc);

print(Foo.foo('world'));

print('Time now:', Foo.bar);

تتوقّع الدالة require سلسلة تصف المسار المطلق إلى موقع الوحدة. على وجه التحديد، يكون وسيطة require() على الشكل 'pathToRepository:pathToModuleScript'. يمكنك تحميل الوحدات فقط من المستودعات التي تملكها و/أو لديك إذن قراءة فيها. إذا أردت أن يتمكّن الآخرون من استخدام الوحدة، يجب مشاركة المستودع مع المستخدمين الآخرين الذين تريد منحهم إذن الوصول. يمكنك توثيق الوحدة النمطية لمساعدة الآخرين على فهم كيفية استخدامها، ونحن ننصح باستخدام نمط JSDoc مع العلامة @module.

يمكنك استخدام مَعلمة عنوان URL ‏?scriptPath={repo}:{script} لمشاركة مرجع إلى ملف في المستودع، مثلاً https://code.earthengine.google.com/?scriptPath=users/username/utils:utils. عند الانتقال إلى عنوان URL، ستتم إضافة الملف المرجعي والمستودع الخاص به إلى دليل Reader أو Writer في علامة التبويب البرامج النصية، وذلك حسب مستوى الإذن الذي لديك للمستودع المشترَك.

Asset Manager (علامة التبويب "مواد العرض")

يمكنك العثور على "إدارة مواد العرض" في علامة التبويب مواد العرض في اللوحة اليمنى. استخدِم "أداة إدارة مواد العرض" (الشكل 3) لتحميل مواد عرض الصور الخاصة بك وإدارتها في Earth Engine. راجِع صفحة "مدير مواد العرض" للحصول على التفاصيل.

مدير مواد العرض

الشكل 3: مدير مواد العرض

يمكن مشاركة نصوص أداة تعديل الرموز البرمجية من خلال عنوان URL مشفّر. توضّح الأقسام التالية الطرق المختلفة لإنشاء عنوان URL لبرنامج نصي، والخيارات المتاحة، وطرق إدارة عناوين URL للبرامج النصية.

يوفّر الزر "الحصول على الرابط" في أعلى "أداة تعديل الرموز" (الشكل 4) واجهة لإنشاء عناوين URL للبرامج النصية وضبط خيارات سلوك البرنامج النصي. يُرجى ملاحظة الفروق بين عناوين URL الخاصة باللقطات والنصوص البرمجية المحفوظة الموضّحة أدناه.

‏

الشكل 4. زر "الحصول على الرابط"

يمكن مشاركة الرمز في "أداة التعديل" من خلال عنوان URL مشفّر للقطة شاشة يتم إنشاؤه عند النقر على الزر "الحصول على الرابط" في أعلى "أداة تعديل الرمز". عندما ينتقل مستخدم لديه حساب على Earth Engine إلى عنوان URL، سينتقِل المتصفّح إلى "محرّر التعليمات البرمجية" وسيُعيد إنشاء البيئة كما كانت عند إنشاء الرابط، بما في ذلك التعليمات البرمجية وعمليات الاستيراد وطبقات الخريطة وموضع الخريطة. سيؤدي النقر على الزر "الحصول على الرابط" إلى نسخ رابط النص البرمجي تلقائيًا إلى الحافظة. بالإضافة إلى ذلك، سيظهر مربّع حوار يوفّر خيارات للتحكّم في تنفيذ النص البرمجي المشترَك، إلى جانب أزرار لنسخ الرابط الذي تم إنشاؤه والانتقال إليه. تشمل خيارات التحكّم منع النص البرمجي من التنفيذ تلقائيًا، وإخفاء جزء الرمز عندما يفتح أحد المستخدمين الرابط المشترَك. يمكن إغلاق مربّع الحوار القابل للسحب من خلال مفتاح Esc أو النقر في أي مكان آخر على الصفحة.

تتضمّن النصوص البرمجية المحفوظة خيارًا لمشاركة رابط سيحمّل دائمًا أحدث نسخة محفوظة، ولن يتمكّن من الوصول إليه سوى أنت والمستخدمون الآخرون الذين لديهم إذن حالي بالوصول إلى المستودع الذي يحتوي على النص البرمجي. لاستخدام هذه الميزة، حمِّل نصًا برمجيًا محفوظًا من علامة التبويب "إدارة النصوص البرمجية" (Script Manager)، وانقر على سهم القائمة المنسدلة على يسار الزر "الحصول على الرابط" (Get Link) واختَر "نسخ مسار النص البرمجي" (Copy Script Path). سيظهر مربّع حوار يعرض عنوان URL الخاص بالبرنامج النصي القابل للمشاركة. يُرجى العِلم أنّه تم أيضًا ضبط عنوان URL للبرنامج النصي في شريط العناوين في المتصفّح. للحصول على إرشادات حول مشاركة المستودع مع مستخدمين آخرين، يُرجى الاطّلاع على قسم "إدارة النصوص البرمجية".

يحتوي زر القائمة المنسدلة على يسار الزر "الحصول على الرابط" على خيار "إدارة الروابط". سيؤدي النقر على هذا الخيار إلى تحميل علامة تبويب متصفّح جديدة تتضمّن واجهة تتيح لك استرجاع روابط النصوص البرمجية التي تم إنشاؤها سابقًا وإزالتها وتنزيلها. سيؤدي اختيار نص برمجي والضغط على زر التنزيل إلى تنزيل مجلد مضغوط ("code_editor_links.zip") إلى نظامك يحتوي على تمثيل ملف ‎ .txt لكل نص برمجي تم اختياره.

تتيح الوحدة ui.url إجراء تعديل آلي على معرّف الجزء من عنوان URL للنص البرمجي من خلال الطريقتَين get وset. وهذا يعني أنّ النصوص البرمجية في "أداة تعديل الرموز البرمجية" وتطبيقات Earth Engine يمكنها قراءة القيم وتخزينها في عنوان URL الخاص بالصفحة. لاحظ نهاية عنوانَي URL التاليَين، حيث يضبط العنوان الأول المتغيّر debug على false، بينما يضبطه العنوان الثاني على true. انتقِل إلى كلا الرابطَين ولاحظ أنّ مربّع الاختيار "تصحيح الأخطاء" في وحدة التحكّم غير محدّد في الرابط الأول، بينما هو محدّد في الرابط الثاني، ما يؤدي إلى تغيير سلوك كل نص برمجي.

https://code.earthengine.google.com/5695887aad76979388a723a85339fbf2#debug=false;

https://code.earthengine.google.com/5695887aad76979388a723a85339fbf2#debug=true;

يمكن استخدام هذه الميزة لضبط مستوى تكبير الخريطة ومركزها، بالإضافة إلى سلوكيات أخرى قد تريد تخصيصها عند إرسال روابط إلى أشخاص أو مجموعات معيّنة.

أداة البحث

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

عمليات الاستيراد

يتم تنظيم نتائج استيراد مجموعات البيانات إلى النص البرمجي في قسم عمليات الاستيراد في أعلى النص البرمجي، وتبقى مخفية إلى أن تستورد شيئًا. بعد إنشاء بعض عمليات الاستيراد، من المفترض أن يظهر لك شيء مشابه للشكل 5. لنسخ عمليات الاستيراد إلى نص برمجي آخر أو لتحويل عمليات الاستيراد إلى JavaScript، انقر على رمز بجانب العنوان عمليات الاستيراد وانسخ الرمز الذي تم إنشاؤه إلى النص البرمجي. يمكنك حذف عملية الاستيراد باستخدام الرمز .

قسم "استيراد" في "أداة تعديل الرموز"

الشكل 5. قسم عمليات الاستيراد في أعلى "أداة تعديل الرموز"

خريطة

يشير عنصر Map في واجهة برمجة التطبيقات إلى عرض الخريطة في "أداة تعديل الرموز". على سبيل المثال، سيؤدي إدخال Map.getBounds() إلى عرض المنطقة الجغرافية المرئية في "محرّر الرموز". راجِع وظائف Map في واجهة برمجة التطبيقات للاطّلاع على خيارات التخصيص الأخرى لهذا العرض.

أداة إدارة الطبقات

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

أداة عرض الطبقات

الشكل 6. أداة عرض الطبقات

علامة التبويب "أداة الفحص"

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

علامة التبويب "أداة الفحص"

الشكل 7. تعرض علامة التبويب "الفاحص" معلومات حول موقع المؤشر وقيم الطبقة أسفل المؤشر.

علامة التبويب "وحدة التحكّم"

عندما print() شيئًا من النص البرمجي، مثل نص أو كائنات أو رسومات بيانية، ستظهر النتيجة في وحدة التحكّم. وحدة التحكّم تفاعلية، لذا يمكنك توسيع العناصر المطبوعة للحصول على مزيد من التفاصيل حولها.

علامة التبويب "المهام"

مهام Earth Engine هي عمليات يمكن أن تستغرق وقتًا أطول بكثير من المهلة المحدّدة لطلبات البيانات العادية من واجهة برمجة التطبيقات. تُعدّ هذه المهام الطويلة الأمد الآلية الوحيدة لإنشاء عناصر ثابتة في Earth Engine والأنظمة المجاورة (Google Cloud Storage وGoogle Drive وما إلى ذلك)، وهي تنقسم إلى فئتين: Import وExport.

يمكن استخدام مهام الاستيراد لتحميل الصور أو تحميل الجداول إلى Earth Engine من مجموعة متنوعة من أنواع الملفات (.csv و.tif وما إلى ذلك). يمكن استخدام مهام التصدير لتنفيذ النتائج وكتابتها من نظام الحساب في Earth Engine (راجِع دليل تصدير البيانات).

بالنسبة إلى عمليات التصدير، سيؤدي كل طلب إلى وظيفة Export في "أداة تعديل الرموز" إلى ملء إدخال في قسم المهام التي لم يتم إرسالها ضمن علامة التبويب المهام. لإرسال مهمة تصدير إلى الخادم، انقر على الزر تشغيل بجانب المهمة. سيظهر مربّع حوار للإعدادات يتيح لك تحديد مجموعة متنوّعة من المَعلمات الخاصة بالمهمة. إذا تم تحديد المهمة بالكامل في وقت إنشائها (أي أنّ طلب Export يتضمّن جميع المَعلمات اللازمة)، اضغط مع الاستمرار على ctrl أو ⌘ أثناء النقر على تشغيل لإرسال المهمة بدون عرض مربّع الحوار.

بالنسبة إلى عمليات الاستيراد، يتم تحميل الملف على الجهاز قبل إرسال المهمة إلى الخادم. ستظهر المهام التي يتم استيرادها في مرحلة التحميل مع مستوى تقدّمها في قسم المهام التي لم يتم إرسالها، وسيتم إرسالها تلقائيًا إلى الخادم بعد اكتمال عملية تحميل الملف.

لا تظهر المهام التي لم يتم إرسالها إلا على الصفحة التي تم إنشاؤها فيها، ويتم فقدانها عند إغلاق الصفحة. بعد إرسال مهمة إلى الخادم، سيؤدي النقر على صفها في واجهة المستخدم إلى توفير معلومات وخيارات إضافية حول حالة المهمة، بما في ذلك خيار طلب الإلغاء.

لعرض مهام متعددة وإلغائها في عرض ملء الشاشة (بما في ذلك على أجهزة الجوّال)، استخدِم صفحة "المهام" في Cloud Console.

Profiler

تعرض أداة Profiler معلومات حول الموارد (وقت وحدة المعالجة المركزية والذاكرة) التي تستهلكها خوارزميات معيّنة وأجزاء أخرى من عملية حسابية. يساعد ذلك في تشخيص سبب بطء تنفيذ البرنامج النصي أو تعذّره بسبب حدود الذاكرة. لاستخدام أداة Profiler، انقر على الخيار التشغيل باستخدام أداة Profiler في القائمة المنسدلة ضمن الزر "تشغيل". كاختصار، اضغط مع الاستمرار على Alt (أو Option على جهاز Mac) وانقر على "تشغيل"، أو اضغط على Ctrl+Alt+Enter. سيؤدي ذلك إلى تفعيل علامة التبويب Profiler على الجانب الأيسر من محرِّر الرموز. أثناء تنفيذ النص البرمجي، ستعرض علامة التبويب Profiler جدولاً يتضمّن معلومات حول استخدام الموارد من النص البرمجي. سيؤدي النقر على الزر تشغيل (بدون إنشاء ملف تعريف) إلى إخفاء علامة التبويب أداة إنشاء الملفات الشخصية وإيقاف الأداة.

راجِع صفحة نظرة عامة على عملية الاحتساب للاطّلاع على تفاصيل حول نتائج أداة تحليل الأداء.

مساعد مستند إلى الذكاء الاصطناعي (علامة التبويب "اسأل")

يتضمّن "أداة تعديل الرموز" مساعدًا مستندًا إلى الذكاء الاصطناعي من Gemini لمساعدتك في كتابة النصوص البرمجية وتصحيح أخطائها وفهمها. يتوفّر المساعد في علامة التبويب طرح سؤال في اللوحة اليسرى.

للحصول على تفاصيل حول كيفية إعداد المساعد واستخدامه، يُرجى الاطّلاع على دليل مساعد الذكاء الاصطناعي في "أداة تعديل الرموز" في Earth Engine.

أدوات الهندسة

يمكنك أيضًا استيراد الأشكال الهندسية إلى النص البرمجي من خلال رسمها على الشاشة. لإنشاء أشكال هندسية، استخدِم أدوات رسم الأشكال الهندسية في أعلى يمين شاشة الخريطة (الشكل 8). لرسم نقاط، استخدِم رمز العلامة المكانية ، ولرسم خطوط، استخدِم رمز الخط ، ولرسم مضلّعات، استخدِم رمز المضلّع ، ولرسم مستطيلات، استخدِم رمز المستطيل . (يُرجى العِلم أنّ المستطيلات هي أشكال هندسية مستوية، لذا لا يمكن وضعها في طبقة تحتوي على أشكال هندسية جيوديسية، مثل الخطوط والمضلّعات).

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

الشكل 8. توجد أدوات رسم الأشكال الهندسية في الزاوية العلوية اليمنى من عرض الخريطة.

لضبط طريقة استيراد الأشكال الهندسية إلى النص البرمجي، انقر على رمز بجانب الطبقة في قسم عمليات استيراد الأشكال الهندسية على الخريطة أو في قسم عمليات الاستيراد في أداة تعديل الرموز. سيتم عرض أداة إعدادات طبقة الأشكال الهندسية في مربّع حوار يشبه الشكل 9. يُرجى العِلم أنّه يمكنك استيراد الأشكال المرسومة كأشكال هندسية أو عناصر أو مجموعات عناصر. تتيح لك إعدادات استيراد الأشكال الهندسية أيضًا تغيير لون عرض الطبقة، أو إضافة خصائص إلى الطبقة (إذا تم استيرادها كـ Feature أو FeatureCollection)، أو إعادة تسمية الطبقة.

أداة إعدادات الهندسة

الشكل 9. أداة ضبط الأشكال الهندسية

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

يُرجى مساعدتي بخصوص ذلك.

انقر على الزر في أعلى يسار "محرّر الرموز" للاطّلاع على روابط تؤدي إلى دليل المطوّرين هذا ومنتديات المساعدة الأخرى وجولة إرشادية في "محرّر الرموز" وقائمة باختصارات لوحة المفاتيح التي تساعد في كتابة الرموز وتشغيلها وعرض البيانات على الخريطة. انقر على الزر لإرسال تقرير عن خطأ أو طلب ميزة جديدة أو اقتراح مجموعة بيانات أو إرسال ملاحظات أخرى لا تتطلّب ردًا.