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

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

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

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

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

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

محرِّر JavaScript

سينفّذ محرِّر JavaScript ما يلي:

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

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

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

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

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

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

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

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

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

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

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

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

من أفضل الممارسات كتابة رمز برمجي وحدات وقابل لإعادة الاستخدام يمكن مشاركته بين النصوص البرمجية بدون عمليات نسخ ولصق مكثفة. لتفعيل التطوير المُركّب، يوفّر 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 في علامة التبويب النصوص البرمجية، استنادًا إلى مستوى إذنك للمستودع المشترَك.

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

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

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

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

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

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

‏

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

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

تتضمّن النصوص البرمجية المحفوظة خيارًا لمشاركة رابط سيحمِّل دائمًا أحدث نسخة محفوظة، ولا يمكن لأحد الوصول إليها إلا أنت والمستخدمون الآخرون الذين لديهم إذن وصول حالي إلى المستودع الذي يحتوي على النص البرمجي. لاستخدام هذه الميزة، حمِّل ملفًا برمجيًا محفوظًا من علامة التبويب "مدير النصوص البرمجية"، وانقر على السهم المنسدلة على يسار الزر "الحصول على رابط" واختَر "نسخ مسار النص البرمجي". سيظهر مربّع حوار يعرض عنوان 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;

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

أداة البحث

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

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

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

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

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

خريطة

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

مدير الطبقات

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

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

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

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

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

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

الشكل 7: تعرض علامة التبويب "المدقق" معلومات عن موقع المؤشر و قيم الطبقة تحت المؤشر.

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

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

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

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

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

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

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

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

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

أداة تحليل الأداء

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

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

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

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

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

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

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

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

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

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

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

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