Penginstalan NPM

Earth Engine JavaScript API didistribusikan sebagai paket npm yang di-hosting di GitHub. Petunjuk berikut memberikan ringkasan tentang cara menginstal Google Earth Engine JavaScript API. Untuk menggunakan Earth Engine JavaScript API, Anda harus menginstal library klien dan dependensinya di komputer Anda, lalu menyiapkan kredensial autentikasi.

Library klien JavaScript tidak menyertakan semua fungsi Editor Kode Earth Engine. Khususnya, fitur antarmuka pengguna seperti tombol, panel, dan diagram tidak disertakan.

Menginstal library klien

1. Menyiapkan Node.js dan npm

npm adalah pengelola paket untuk JavaScript dan Node.js. Verifikasi bahwa Anda memiliki Node.js 6+ dan npm 3+.

node --version
npm --version

Jika perlu, instal keduanya menggunakan penginstal resmi untuk platform Anda.

2. Menginstal library klien Earth Engine

Library klien dapat diinstal dari npm dengan perintah berikut:

npm install --save @google/earthengine

Setelah diinstal, library klien akan ditempatkan dalam direktori project saat ini: node_modules/@google/earthengine/*. Pada project mendatang, instal klien dengan cara yang sama.

3. Menggunakan library klien dalam aplikasi

Dalam kode aplikasi Anda, panggil Earth Engine API:

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

Memperbarui library klien

Gunakan npm untuk mengupdate library klien ke versi terbaru. Dari direktori project saat ini: 
npm update @google/earthengine

Pelajari lebih lanjut cara mengupdate pustaka dengan npm.

Meng-uninstal library klien

Untuk meng-uninstall menggunakan pengelola paket npm, jalankan perintah berikut:

npm uninstall --save @google/earthengine

Tindakan ini akan menghapus node_modules/@google/earthengine dari project saat ini, tetapi tidak memengaruhi project apa pun di direktori lain pada mesin yang sama.

Buat Project Cloud dan aktifkan Earth Engine API

Ikuti petunjuk ini untuk membuat project Cloud dan mengaktifkan Earth Engine API.

Menyiapkan Kredensial Autentikasi

Earth Engine API menggunakan protokol OAuth 2.0 untuk mengautentikasi klien berbasis browser. Untuk autentikasi sisi server di Node.js, sebaiknya gunakan akun layanan. Aplikasi web dapat menggunakan salah satu pendekatan, dengan kelebihan dan kekurangan yang dibahas di bawah.

Autentikasi sisi klien dengan OAuth

Dengan autentikasi sisi klien di browser web, pengguna aplikasi Anda login dengan Akun Google mereka sendiri. Pengguna ini harus sudah diberi otorisasi untuk mengakses Earth Engine, dan harus memiliki izin untuk membaca aset yang digunakan oleh aplikasi Anda.

Setelah membuat Client ID OAuth 2.0, lakukan autentikasi seperti yang ditunjukkan di bawah (ganti my-project dengan ID project Google Cloud Anda):

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

Autentikasi sisi server dengan akun layanan

Dengan autentikasi sisi server, kunci pribadi disimpan dengan aplikasi Anda, sehingga aplikasi tersebut dapat mengakses Earth Engine API melalui akun layanan. Pengguna aplikasi Anda tidak memerlukan akses mereka sendiri ke Earth Engine, dan tidak diwajibkan untuk login.

Di Node.js, hanya autentikasi sisi server yang disediakan oleh library klien.

Setelah membuat akun layanan baru, gunakan kunci pribadi JSON Anda untuk mengautentikasi (ganti my-project dengan ID project Google Cloud Anda):

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

Menguji penginstalan

Untuk menguji bahwa autentikasi telah disiapkan dengan benar, jalankan skrip berikut (ganti my-project dengan ID project Google Cloud Anda):

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

Jika semuanya diinstal dengan benar, metadata untuk gambar akan dicetak.