نصب NPM

Earth Engine JavaScript API به‌عنوان بسته npm توزیع می‌شود که در GitHub میزبانی می‌شود. دستورالعمل‌های زیر نمای کلی نصب Google Earth Engine JavaScript API را ارائه می‌دهد. برای استفاده از Earth Engine JavaScript API، باید کتابخانه کارخواه و وابستگی‌های آن را در رایانه‌تان نصب کنید و سپس اعتبارنامه‌های اصالت‌سنجی را راه‌اندازی کنید.

کتابخانه مشتری جاوا اسکریپت شامل همه عملکردهای Earth Engine ویرایشگر کد نیست. به‌ویژه، ویژگی‌های میانای کاربر مانند دکمه‌ها، پانل‌ها، و نمودارها مستثنی هستند.

نصب کتابخانه مشتری

۱. راه‌اندازی Node.js و npm

npm مدیر بسته برای جاوا اسکریپت و Node.js است. مطمئن شوید که Node.js 6+‎ و npm 3+‎ را دارید.

node --version
npm --version

درصورت نیاز، هر دو را بااستفاده از نصب‌کننده رسمی پلاتفرم خود نصب کنید.

۲. نصب کتابخانه کارخواه Earth Engine

کتابخانه کارخواه را می‌توان از npm با فرمان زیر نصب کرد:

npm install --save @google/earthengine

پس‌از نصب، کتابخانه مشتری در دایرکتوری پروژه فعلی قرار می‌گیرد: node_modules/@google/earthengine/*. در پروژه‌های آینده، کلاینت را به همین روش نصب کنید.

۳. استفاده از کتابخانه مشتری در برنامه

در کد برنامه‌تان، Earth Engine API را درخواست کنید:

var ee = require('@google/earthengine');

به‌روزرسانی کتابخانه کارخواه

از npm برای به‌روزرسانی کتابخانه کارخواه به جدیدترین نسخه استفاده کنید. از فهرست راهنمای پروژه فعلی:
npm update @google/earthengine

درباره به‌روزرسانی کتابخانه‌ها با npm بیشتر بدانید.

حذف نصب کتابخانه کارخواه

برای حذف نصب بااستفاده از مدیر بسته npm، فرمان زیر را اجرا کنید:

npm uninstall --save @google/earthengine

با این کار، node_modules/@google/earthengine از پروژه فعلی برداشته می‌شود، اما بر پروژه‌های موجود در دایرکتوری‌های دیگر در همان دستگاه تأثیری نمی‌گذارد.

ایجاد پروژه Cloud و فعال کردن Earth Engine API

این دستورالعمل‌ها را برای ایجاد پروژه Cloud و فعال کردن 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);
});

اگر همه چیز به‌درستی نصب شده باشد، فراداده تصویر باید چاپ شود.