نظرة عامة على 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 وLinux. إذا كنت تستخدم Python على نظام التشغيل Windows، جرِّب هذا الإجراء.

تفعيل واجهة برمجة التطبيقات Earth Engine API في مشروعك على Google Cloud

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

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

حساب الخدمة

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

Python

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

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

Node.js

ثبِّت تبعيات المشروع من خلال تشغيل npm install. سيتم نسخ Earth Engine Node.js API وأي تبعيات أخرى إلى مجلد ./node_modules في دليل مشروعك. إذا تعذّر التثبيت، تحقَّق مما يلي: تم تثبيت إصدار حديث من Node.js. 

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

معرّف عميل OAuth 2.0

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

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

إعداد بيئة التطوير المحلية

Python

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

./build.sh

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

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

dev_appserver.py

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

Node.js

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

التشغيل على الجهاز

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

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

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