NPM इंस्टॉल करना

Earth Engine JavaScript API को एक npm पैकेज के तौर पर डिस्ट्रिब्यूट किया जाता है. इसे GitHub पर होस्ट किया जाता है. यहां दिए गए निर्देशों में, Google Earth Engine JavaScript API को इंस्टॉल करने के बारे में खास जानकारी दी गई है. Earth Engine JavaScript API का इस्तेमाल करने के लिए, आपको अपने कंप्यूटर पर क्लाइंट लाइब्रेरी और उससे जुड़ी डिपेंडेंसी इंस्टॉल करनी होंगी. इसके बाद, पुष्टि करने के क्रेडेंशियल सेट अप करें.

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 हट जाता है. हालांकि, उसी मशीन पर मौजूद अन्य डायरेक्ट्री में मौजूद किसी भी प्रोजेक्ट पर इसका असर नहीं पड़ता.

Cloud प्रोजेक्ट बनाना और Earth Engine API को चालू करना

Cloud प्रोजेक्ट बनाने और Earth Engine API को चालू करने के लिए, इन निर्देशों का पालन करें.

पुष्टि करने के क्रेडेंशियल सेट अप करना

Earth Engine API, ब्राउज़र पर काम करने वाले क्लाइंट की पुष्टि करने के लिए, OAuth 2.0 प्रोटोकॉल का इस्तेमाल करते हैं. Node.js में सर्वर साइड की पुष्टि करने के लिए, सेवा खातों का इस्तेमाल करने का सुझाव दिया जाता है. वेब ऐप्लिकेशन, इनमें से किसी भी तरीके का इस्तेमाल कर सकते हैं. इनके फ़ायदों और नुकसानों के बारे में यहां बताया गया है.

OAuth की मदद से क्लाइंट-साइड की पुष्टि

वेब ब्राउज़र में क्लाइंट-साइड पुष्टि की सुविधा की मदद से, आपके ऐप्लिकेशन के उपयोगकर्ता अपने Google खातों से लॉग इन करते हैं. इन उपयोगकर्ताओं के पास पहले से ही Earth Engine को ऐक्सेस करने की अनुमति होनी चाहिए. साथ ही, उनके पास आपके ऐप्लिकेशन में इस्तेमाल की गई एसेट को पढ़ने की अनुमति भी होनी चाहिए.

OAuth 2.0 क्लाइंट आईडी बनाने के बाद, नीचे दिखाए गए तरीके से पुष्टि करें:

// 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);
  });
};

// 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 निजी कुंजी का इस्तेमाल करें:

// 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);
  });
};

// Authenticate using a service account.
ee.data.authenticateViaPrivateKey(privateKey, runAnalysis, function(e) {
  console.error('Authentication error: ' + e);
});

इंस्टॉलेशन की जांच करना

पुष्टि करने की सुविधा सही तरीके से सेट अप की गई है या नहीं, यह जांचने के लिए यह स्क्रिप्ट चलाएं:

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();

// Run an Earth Engine script.
var image = new ee.Image('srtm90_v4');
image.getMap({min: 0, max: 1000}, function(map) {
  console.log(map);
});

अगर सब कुछ सही तरीके से इंस्टॉल किया गया है, तो किसी इमेज का मेटाडेटा प्रिंट हो जाना चाहिए.