NPM ইনস্টলেশন

Earth Engine JavaScript API, npm প্যাকেজ হিসেবে ডিস্ট্রিবিউট করা হয় যা GitHub-এ হোস্ট করা হয়। নিচে দেওয়া নির্দেশাবলী থেকে Google Earth Engine JavaScript API ইনস্টল করার ব্যাপারে এক নজরে জানতে পারবেন। Earth Engine JavaScript API ব্যবহার করতে, আপনাকে কম্পিউটারে ক্লায়েন্ট লাইব্রেরি ও তার ডিপেন্ডেন্সি ইনস্টল করতে হবে এবং তারপর যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল সেট-আপ করতে হবে।

জাভাস্ক্রিপ্ট ক্লায়েন্ট লাইব্রেরিতে Earth Engine কোড এডিটরের সব কার্যকারিতা অন্তর্ভুক্ত নেই। বিশেষ করে, বোতাম, প্যানেল ও চার্টের মতো ইউজার ইন্টারফেস ফিচার বাদ দেওয়া হয়েছে।

ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন

১. Node.js ও npm সেট-আপ করা

npm হল JavaScript এবং 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 API, ব্রাউজার-ভিত্তিক ক্লায়েন্টদের যাচাই করার জন্য 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);
});

সবকিছু সঠিকভাবে ইনস্টল করা থাকলে, ছবির মেটাডেটা প্রিন্ট করা উচিত।