Earth Engine User Interface API

Earth Engine menyediakan akses ke widget antarmuka pengguna (UI) sisi klien melalui paket ui. Gunakan paket ui untuk membuat antarmuka grafis untuk skrip Earth Engine Anda. Antarmuka ini dapat mencakup widget input sederhana seperti tombol dan kotak centang, widget yang lebih kompleks seperti diagram dan peta, panel untuk mengontrol tata letak UI, dan pengendali peristiwa untuk interaksi antara widget UI. Jelajahi fungsi lengkap ui API di tab Dokumen di sisi kiri Editor Kode. Contoh berikut menggunakan paket ui untuk mengilustrasikan fungsi dasar untuk membuat widget, menentukan perilaku saat pengguna mengklik widget, dan menampilkan widget.

Halo, dunia!

Contoh ini mewakili UI sederhana dari tombol yang ditampilkan di konsol. Mengklik tombol akan membuat 'Hello, world!' dicetak ke konsol:

Editor Kode (JavaScript)

// Make a button widget.
var button = ui.Button('Click me!');

// Set a callback function to run when the
// button is clicked.
button.onClick(function() {
  print('Hello, world!');
});

// Display the button in the console.
print(button);

Perhatikan bahwa pertama-tama, tombol dibuat dengan satu argumen: labelnya. Selanjutnya, fungsi onClick() tombol dipanggil. Argumen untuk onClick() adalah fungsi lain yang akan dijalankan setiap kali tombol diklik. Mekanisme fungsi yang akan dipanggil (fungsi "callback") saat peristiwa terjadi disebut "pengelola peristiwa" dan digunakan secara luas di library UI. Dalam contoh ini, saat tombol diklik, fungsi akan mencetak 'Halo, dunia!' ke konsol.

Mutabilitas

Perhatikan bahwa tidak seperti objek dalam namespace ee.*, objek dalam namespace ui.* dapat diubah. Jadi, Anda tidak perlu menetapkan ulang objek ke variabel setiap kali memanggil fungsi instance pada objek. Cukup memanggil fungsi akan memutasi (mengubah) widget. Menambahkan kode berikut ke contoh sebelumnya akan mendaftarkan callback lain untuk peristiwa klik tombol:

Editor Kode (JavaScript)

// Set another callback function on the button.
button.onClick(function() {
  print('Oh, yeah!');
});

Salin kode ini ke akhir contoh sebelumnya, lalu klik Run. Sekarang, saat Anda mengklik tombol, kedua pesan akan dicetak ke konsol.

Gunakan halaman UI untuk mempelajari lebih lanjut cara membuat UI untuk skrip Earth Engine Anda. Halaman Widget menyediakan tur visual dan menjelaskan fungsi dasar widget dalam paket ui. Halaman Panel dan Tata Letak menjelaskan penampung dan tata letak tingkat teratas yang dapat Anda gunakan untuk mengatur dan menyusun widget. Halaman Peristiwa memiliki detail tentang cara mengonfigurasi perilaku dan interaksi widget di UI Anda.