Pengantar JavaScript untuk Earth Engine

Tutorial ini mencakup JavaScript yang cukup untuk membantu Anda mulai menulis skrip Earth Engine. Untuk tutorial JavaScript yang lebih menyeluruh, lihat sumber daya developer Mozilla ini. Untuk pengantar pemrograman, dengan contoh dalam JavaScript, lihat Eloquent JavaScript. Untuk saran 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 Code Editor:

Code Editor (JavaScript)

print('Hello World!');

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

Code Editor (JavaScript)

// print('Hello World!');

Sebaiknya tambahkan banyak komentar dalam kode Anda, untuk menjelaskan apa yang sedang Anda coba lakukan. Sebaiknya hapus juga kode yang dikomentari yang tidak lagi melakukan apa pun. 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 di variabel bernama greetString:

Code Editor (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:

Code Editor (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 dengan koma, setiap argumen dicetak di baris yang berbeda.

Daftar

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

Code Editor (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 lain. Contoh:

Code Editor (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:

Code Editor (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 penggunaan kembali kode dengan mengelompokkan serangkaian operasi. Tentukan fungsi dengan kata kunci function. Nama fungsi dimulai dengan huruf dan memiliki sepasang tanda kurung di bagian 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 masuk ke 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:

Code Editor (JavaScript)

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

Mari kita pertimbangkan barisnya satu per satu. Baris pertama membuat fungsi baru dan menetapkannya ke variabel myFunction. Variabel ini dapat diberi nama apa pun. Hal 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 nama yang Anda berikan, nama tersebut 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:

Code Editor (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!'));

Berikut adalah contoh fungsi yang ditentukan pengguna. Ada juga banyak fungsi Earth Engine bawaan. Jelajahi tab DokumenEditor Kode untuk mempelajari fungsi bawaan ini. Berikut adalah contoh fungsi Earth Engine yang sangat sederhana:

Code Editor (JavaScript)

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

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