يتم توزيع واجهة برمجة التطبيقات Earth Engine JavaScript API على شكل حزمة npm مستضافة على GitHub. تقدّم التعليمات التالية نظرة عامة على تثبيت Google Earth Engine JavaScript API. لاستخدام واجهة برمجة التطبيقات JavaScript في Earth Engine، عليك تثبيت مكتبة البرامج والتبعيات الخاصة بها على جهاز الكمبيوتر ثم إعداد بيانات اعتماد المصادقة.
لا تتضمّن مكتبة برامج JavaScript جميع وظائف أداة تعديل الرموز في Earth Engine. وتجدر الإشارة إلى أنّه يتم استبعاد ميزات واجهة المستخدم، مثل الأزرار واللوحات والرسوم البيانية.
تثبيت مكتبة البرامج
1. إعداد Node.js وnpm
npm هو مدير حِزم للغة JavaScript وNode.js. تأكَّد من أنّ لديك Node.js 6+ وnpm 3+.
node --version npm --version
إذا لزم الأمر، يمكنك تثبيت كليهما باستخدام أداة التثبيت الرسمية لنظام التشغيل لديك.
2. تثبيت مكتبة برامج Earth Engine
يمكن تثبيت مكتبة البرامج من npm باستخدام الأمر التالي:
npm install --save @google/earthengine
بعد التثبيت، يتم وضع مكتبة البرامج ضمن دليل المشروع الحالي: node_modules/@google/earthengine/*. في المشاريع المستقبلية، ثبِّت البرنامج بالطريقة نفسها.
3- استخدام مكتبة البرامج في تطبيق
في الرمز البرمجي للتطبيق، اطلب Earth Engine API:
var ee = require('@google/earthengine');
تحديث مكتبة البرامج
استخدِم npm لتحديث مكتبة البرامج إلى أحدث إصدار. من دليل المشروع الحالي:npm update @google/earthengine
مزيد من المعلومات حول تعديل المكتبات باستخدام npm
إلغاء تثبيت مكتبة البرامج
لإلغاء التثبيت باستخدام أداة إدارة الحِزم npm، نفِّذ الأمر التالي:
npm uninstall --save @google/earthengine
يؤدي هذا الإجراء إلى إزالة node_modules/@google/earthengine من المشروع الحالي، ولكنّه
لا يؤثر في أي مشاريع في أدلة أخرى على الجهاز نفسه.
إنشاء مشروع على السحابة الإلكترونية وتفعيل واجهة برمجة تطبيقات Earth Engine
اتّبِع هذه التعليمات لإنشاء مشروع على السحابة الإلكترونية وتفعيل Earth Engine API.
إعداد بيانات اعتماد المصادقة
تستخدم واجهات برمجة تطبيقات Earth Engine بروتوكول OAuth 2.0 لمصادقة برامج العميل المستندة إلى المتصفّح. للمصادقة من جهة الخادم في Node.js، ننصح باستخدام حسابات الخدمة. يمكن لتطبيقات الويب استخدام أي من الطريقتين، مع مناقشة الإيجابيات والسلبيات أدناه.
المصادقة من جهة العميل باستخدام OAuth
باستخدام المصادقة من جهة العميل في متصفّح الويب، يسجّل مستخدمو تطبيقك الدخول باستخدام حساباتهم على Google. يجب أن يكون هؤلاء المستخدمون مصرَّحًا لهم بالوصول إلى Earth Engine، وأن يكون لديهم إذن بقراءة مواد العرض التي يستخدمها تطبيقك.
بعد إنشاء معرّف عميل OAuth 2.0، يمكنك المصادقة كما هو موضّح أدناه (استبدِل my-project برقم تعريف مشروعك على Google Cloud):
// Load client library. var ee = require('@google/earthengine'); // Initialize client library and run analysis. var initialize = function() { ee.initialize(null, null, function() { // ... run analysis ... }, function(e) { console.error('Initialization error: ' + e); }, null, 'my-project'); }; // Authenticate using an OAuth pop-up. ee.data.authenticateViaOauth(YOUR_CLIENT_ID, initialize, function(e) { console.error('Authentication error: ' + e); }, null, function() { ee.data.authenticateViaPopup(initialize); });
المصادقة من جهة الخادم باستخدام حساب خدمة
باستخدام المصادقة من جهة الخادم، يتم تخزين مفتاح خاص مع تطبيقك، ما يسمح له بالوصول إلى واجهة برمجة التطبيقات Earth Engine API من خلال حساب خدمة. لا يحتاج مستخدمو تطبيقك إلى إذن وصول خاص بهم إلى Earth Engine، ولا يُطلب منهم تسجيل الدخول.
في Node.js، توفّر مكتبة العميل المصادقة من جهة الخادم فقط.
بعد إنشاء حساب خدمة جديد، استخدِم مفتاح JSON الخاص للمصادقة (استبدِل my-project برقم تعريف مشروعك على Google Cloud):
// Require client library and private key. var ee = require('@google/earthengine'); var privateKey = require('./.private-key.json'); // Initialize client library and run analysis. var runAnalysis = function() { ee.initialize(null, null, function() { // ... run analysis ... }, function(e) { console.error('Initialization error: ' + e); }, null, 'my-project'); }; // Authenticate using a service account. ee.data.authenticateViaPrivateKey(privateKey, runAnalysis, function(e) { console.error('Authentication error: ' + e); });
اختبار التثبيت
لاختبار ما إذا تم إعداد المصادقة بشكل صحيح، شغِّل النص البرمجي التالي
(استبدِل my-project برقم تعريف مشروعك على Google Cloud):
var ee = require('@google/earthengine'); // Authenticate using one (but not both) of the methods below. ee.data.authenticateViaOauth(YOUR_CLIENT_ID); ee.data.authenticateViaPrivateKey(YOUR_PRIVATE_KEY); ee.initialize(null, null, null, null, null, 'my-project'); // Run an Earth Engine script. var image = new ee.Image('srtm90_v4'); image.getMap({min: 0, max: 1000}, function(map) { console.log(map); });
إذا تم تثبيت كل شيء بشكل صحيح، من المفترض أن تتم طباعة البيانات الوصفية للصورة.