نظرة عامة على App Engine وEarth Engine

تتيح لك خدمة Google App Engine إنشاء تطبيقاتك المخصّصة وتشغيلها على خوادم Google. يسهل إنشاء تطبيقات App Engine وصيانتها وتوسيع نطاقها مع تغيُّر احتياجاتك من حيث عدد الزيارات ومساحة تخزين البيانات. ما عليك سوى تحميل رمز المصدر لتطبيقك، وسيصبح جاهزًا للاستخدام. إذا كنت جديدًا في تطوير التطبيقات على App Engine، احرص على الاطّلاع على دليل البدء السريع Python أو Node.js في App Engine قبل المتابعة.

يمكن استخدام Earth Engine وApp Engine معًا لإنشاء تطبيقات جغرافية مكانية قابلة للتوسّع. يتضمّن رمز App Engine عادةً مكتبة برامج Python الخاصة بـ Earth Engine ويُرسِل طلبات إلى الخلفية في Earth Engine باستخدام حساب خدمة. وهذا مفيد لأنّه يتيح لأي شخص استخدام تطبيقك بدون تسجيل الدخول أو أن يكون مستخدمًا مسجّلاً في Earth Engine. يُرجى العِلم أنّ حدود الاستخدام العادية في Earth Engine تنطبق على كل حساب من حسابات الخدمة.

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

يحتوي دليل العروض التوضيحية لـ Earth Engine App Engine على GitHub على مجموعة من الأمثلة المفيدة على App Engine. يمكنك الاطّلاع على صفحة "تطبيقات نموذجية" للحصول على وصف موجز لكل مثال. يقدّم هذا المستند تعليمات حول كيفية إعداد ونشر الأمثلة أو التطبيقات المخصّصة التي تنشئها.

نشر تطبيقات App Engine باستخدام Earth Engine

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

تفعيل Earth Engine API في مشروعك على Google Cloud

أنشئ مشروعًا على Google Cloud أو اختَر مشروعًا حاليًا وفعِّل Earth Engine API وفقًا لهذه التعليمات.

إعداد بيانات الاعتماد

حساب الخدمة

يمكن استخدام حساب خدمة للسماح بالطلبات إلى Earth Engine نيابةً عن أي شخص يستخدم تطبيقك. يحتوي ملف config.py على رمز مصادقة باستخدام عنوان البريد الإلكتروني لحساب الخدمة وملف مفتاح خاص. لإعداد المصادقة باستخدام حساب خدمة، اتّبِع هذه التعليمات لإنشاء حساب الخدمة وملف المفتاح الخاص. أدخِل اسمًا لملف المفتاح .private-key.json وانقله إلى دليل مشروعك.

Python

إذا لم يسبق لك ذلك، عليك أولاً إعداد واجهة برمجة التطبيقات Earth Engine Python. اختبِر حساب الخدمة وفقًا لهذه التعليمات.

في حال نجاح الاختبار، عدِّل config.py (أو ملفًا مكافئًا في رمز المصدر) باستخدام عنوان البريد الإلكتروني لحساب الخدمة. (يجب ألا يتغير مسار ملف المفتاح لأنّه موجود في دليل مشروعك).

Node.js

ثبِّت تبعيات المشروع من خلال تنفيذ npm install. سيتم نسخ واجهة برمجة التطبيقات Earth Engine Node.js وأي تبعيات أخرى إلى مجلد ./node_modules في دليل مشروعك. في حال تعذّر التثبيت، تأكَّد من تثبيت إصدار حديث من Node.js. مصادقة المكتبة وتهيئتها، مع استبدال my-project برقم تعريف مشروعك على Google Cloud:

const ee = require('@google/earthengine');
ee.data.authenticateViaPrivateKey('.private-key.json');
ee.initialize(null, null, null, null, null, 'my-project');

معرّف عميل OAuth 2.0

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

  1. إعداد معرّف عميل وفقًا لهذه التعليمات
  2. عدِّل الملف static/script.js (أو ملفًا مكافئًا في رمز المصدر) لاستخدام معرّف العميل.
  3. تأكَّد من توفّر ee_api_js.js في دليل /static/ (أو ما يعادله). يمكنك تنزيله مباشرةً من GitHub أو تثبيته من npm أو نسخه من earthengine-api/javascript/build على نظام الملفات المحلي إذا سبق لك استنساخ مستودع EE API بالكامل.

إعداد بيئة التطوير على الجهاز

Python

اتّبِع التعليمات الواردة في كل دليل أمثلة على GitHub لتنزيل المشروع وإنشائه. إذا كان هناك ملف build.sh، شغِّله من مجلد جذر التطبيق باستخدام الأمر:

./build.sh

سيؤدي نص التهيئة البرمجي إلى تنزيل الاعتماديات وتثبيت أدوات سطر الأوامر من Google، إذا لم تكن متوفّرة على نظامك. سيتم نسخ واجهة برمجة التطبيقات Earth Engine Python API والملفات التابعة لها إلى مجلد ./lib في دليل مشروعك.

تأكَّد من توفّر أدوات سطر الأوامر في App Engine من خلال تنفيذ ما يلي:

dev_appserver.py

في حال عدم العثور على الأمر، حاوِل تنزيل حزمة تطوير البرامج (SDK) الخاصة بـ Google App Engine للغة Python وتثبيتها يدويًا. وإذا كان الأمر متاحًا، من المفترض أن يتعذّر تنفيذه بسبب ظهور الخطأ "error: too few arguments".

Node.js

لا يلزم إجراء أي عملية إعداد.

التشغيل محليًا

بعد تسجيل حساب الخدمة للحصول على إذن الوصول إلى Earth Engine، يمكنك استخدامه للمصادقة (راجِع config.py) عند اختبار الأمثلة. جرِّب اختبار الأمثلة على جهازك أولاً من خلال الانتقال إلى دليل مشروعك وتنفيذ ما يلي:

Python
dev_appserver.py .
Node.js
npm install
npm start

وجِّه متصفّحك إلى http://localhost:8080 للاطّلاع على التطبيق الذي يتم تشغيله على خادم محلي. سيتم تلقائيًا رصد أي تغييرات تجريها (وتحفظها) عند إعادة تحميل الصفحة.