Pengantar JavaScript untuk Earth Engine

Tutorial ini membahas JavaScript yang cukup untuk membantu Anda mulai menulis skrip Earth Engine. Untuk tutorial JavaScript yang lebih menyeluruh, lihat referensi developer Mozilla ini. Untuk pengantar pemrograman, dengan contoh dalam JavaScript, lihat Eloquent JavaScript. Untuk saran tentang gaya coding JavaScript, lihat Panduan Gaya JavaScript Google. Dalam tutorial ini, Anda akan menulis JavaScript di Editor Kode Earth Engine. Sebelum memulai, gunakan panduan Editor Kode untuk memahami lingkungan Editor Kode.

Halo Dunia!

Saatnya menulis JavaScript pertama Anda untuk Earth Engine. Di browser Chrome, buka code.earthengine.google.com dan salin kode berikut ke Editor Kode:

Editor Kode (JavaScript)

print('Hello World!');

Klik Run dan amati bahwa 'Hello world!' dicetak ke tab Console. Baris di atas adalah pernyataan JavaScript. Dalam JavaScript, pernyataan diakhiri dengan titik koma. Program Earth Engine terdiri dari serangkaian pernyataan seperti ini. Anda dapat mencegah kode berjalan tanpa menghapusnya dengan menjadikannya sebagai komentar. Salah satu cara untuk menjadikan kode sebagai komentar adalah dengan menempatkan dua garis miring // sebelum kode yang tidak ingin Anda jalankan. Contoh:

Editor Kode (JavaScript)

// print('Hello World!');

Sebaiknya masukkan banyak komentar dalam kode Anda, untuk menjelaskan apa yang ingin Anda lakukan. Sebaiknya hapus juga kode yang diberi komentar yang tidak melakukan apa pun lagi. Kedua praktik ini akan meningkatkan keterbacaan kode.

Jenis data JavaScript dasar

String

Menggunakan variabel untuk menyimpan objek dan primitif membantu keterbacaan kode. Misalnya, variabel yang menyimpan objek string ditentukan oleh tanda kutip tunggal ' atau ganda " (tetapi jangan mencampurnya), dengan tanda kutip tunggal lebih disukai. Buat string baru dan simpan dalam variabel bernama greetString:

Editor Kode (JavaScript)

// Use single (or double) quotes to make a string.
var greetString = 'Ahoy there!';
// Use parentheses to pass arguments to functions.
print(greetString);

Angka

Perhatikan bahwa variabel ditentukan dengan kata kunci var. Variabel juga dapat menyimpan angka:

Editor Kode (JavaScript)

// Store a number in a variable.
var number = 42;
print('The answer is:', number);

Dalam contoh ini, perhatikan bahwa saat print() diberi dua argumen yang dipisahkan oleh koma, setiap argumen dicetak pada baris yang berbeda.

Daftar

Tentukan daftar dengan tanda kurung siku []. Daftar angka, misalnya:

Editor Kode (JavaScript)

// Use square brackets [] to make a list.
var listOfNumbers = [0, 1, 1, 2, 3, 5];
print('List of numbers:', listOfNumbers);

Daftar juga dapat menyimpan string atau objek lainnya. Contoh:

Editor Kode (JavaScript)

// Make a list of strings.
var listOfStrings = ['a', 'b', 'c', 'd'];
print('List of strings:', listOfStrings);

Objek

Objek di JavaScript adalah kamus pasangan key: value. Buat objek (atau kamus) menggunakan tanda kurung kurawal {}, misalnya:

Editor Kode (JavaScript)

// Use curly brackets {} to make a dictionary of key:value pairs.
var object = {
  foo: 'bar',
  baz: 13,
  stuff: ['this', 'that', 'the other thing']
};
print('Dictionary:', object);
// Access dictionary items using square brackets.
print('Print foo:', object['foo']);
// Access dictionary items using dot notation.
print('Print stuff:', object.stuff);

Perhatikan bahwa Anda bisa mendapatkan nilai dari kamus dengan memberikan kunci. Contoh ini menunjukkan cara melakukannya untuk objek JavaScript. Nanti, Anda akan mempelajari cara melakukannya untuk kamus yang ada di server Earth Engine.

Fungsi

Fungsi adalah cara lain untuk meningkatkan keterbacaan dan kemampuan untuk digunakan kembali kode dengan mengelompokkan kumpulan operasi. Tentukan fungsi dengan kata kunci function. Nama fungsi dimulai dengan huruf dan memiliki sepasang tanda kurung di akhir. Fungsi sering kali menggunakan parameter yang memberi tahu fungsi apa yang harus dilakukan. Parameter ini berada di dalam tanda kurung (). Kumpulan pernyataan yang membentuk fungsi berada di dalam tanda kurung kurawal. Kata kunci return menunjukkan output fungsi. Ada beberapa cara untuk mendeklarasikan fungsi, tetapi di sini kita akan menggunakan sesuatu seperti ini:

Editor Kode (JavaScript)

var myFunction = function(parameter1, parameter2, parameter3) {
  statement;
  statement;
  statement;
  return statement;
};

Mari kita bahas barisnya satu per satu. Baris pertama membuat fungsi baru dan menetapkannya ke variabel myFunction. Variabel ini dapat diberi nama apa saja. Fungsi ini menentukan cara memanggil fungsi nanti. Istilah dalam tanda kurung setelah nama fungsi (yaitu parameter1, parameter2, parameter3) adalah nama parameter dan dapat diberi nama apa saja, meskipun sebaiknya beri nama unik yang berbeda dari kode di luar fungsi. Apa pun namanya, nama-nama ini adalah nama yang akan digunakan fungsi untuk merujuk ke nilai yang diteruskan ke fungsi saat dipanggil. Nilai parameter setelah diteruskan ke fungsi disebut argumen. Meskipun fungsi dapat menggunakan variabel yang dideklarasikan di luar fungsi (variabel global), argumen fungsi tidak terlihat di luar fungsi. Fungsi dapat menggunakan parameter sebanyak yang Anda butuhkan, bahkan nol. Berikut adalah contoh sederhana fungsi yang hanya menampilkan argumennya:

Editor Kode (JavaScript)

// The reflect function takes a single parameter: element.
var reflect = function(element) {
  // Return the argument.
  return element;
};
print('A good day to you!', reflect('Back at you!'));

Ini adalah contoh fungsi yang ditentukan pengguna (UDF). Ada juga banyak fungsi bawaan Earth Engine. Pelajari tab Docs di Editor Kode untuk mempelajari fungsi bawaan ini. Berikut adalah contoh fungsi Earth Engine yang sangat sederhana:

Editor Kode (JavaScript)

var aString = ee.Algorithms.String(42);

Di bagian berikutnya, pelajari lebih lanjut Objek dan Metode Earth Engine.