نظرة عامة على 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 وتسجيل الدخول قبل استخدام التطبيق.

يحتوي دليل العروض التوضيحية لـ App Engine في Earth 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. سيتم نسخ واجهة برمجة تطبيقات Node.js في Earth Engine وأي تبعيات أخرى إلى مجلد ./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، إذا لم تكن موجودة بالفعل على نظامك. سيتم نسخ واجهة برمجة التطبيقات Python في Earth Engine واعتمادياتها إلى مجلد ./lib في دليل مشروعك.

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

dev_appserver.py

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

Node.js

لا حاجة إلى إجراء أي إعداد.

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

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

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

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