Memvisualisasikan Gambar dan Band Gambar

Setelah siap untuk mulai menulis JavaScript Earth Engine, mulailah dengan menyalin kode berikut ke Editor Kode:

Code Editor (JavaScript)

// Instantiate an image with the Image constructor.
var image = ee.Image('CGIAR/SRTM90_V4');

// Zoom to a location.
Map.setCenter(-112.8598, 36.2841, 9); // Center on the Grand Canyon.

// Display the image on the map.
Map.addLayer(image);

Klik tombol Run di bagian atas Editor Kode dan amati bahwa gambar yang sangat abu-abu muncul di peta. Jangan khawatir, Anda akan segera membuatnya terlihat lebih baik. Jika sintaksis bagian mana pun dalam contoh ini tidak dikenal, pastikan untuk meninjau tutorial JavaScript untuk Earth Engine.

Konstruktor Gambar

Hal baru pertama dalam contoh ini adalah konstruktor gambar ee.Image(). Argumen yang diberikan ke konstruktor adalah ID string gambar dalam katalog data Earth Engine. (Lihat tab Docs, di sebelah kiri Code Editor, untuk melihat daftar lengkap kemungkinan argumen untuk konstruktor gambar. Tab Dokumen menampilkan informasi terbaru tentang kemampuan Earth Engine.)

Untuk menemukan ID gambar, telusuri katalog data Earth Engine menggunakan alat penelusuran di bagian atas Editor Kode. Misalnya, ketik 'ketinggian' di kolom penelusuran dan perhatikan bahwa daftar raster ditampilkan. Klik entri 'SRTM Digital Elevation Data Version 4' untuk melihat informasi selengkapnya tentang set data tersebut. Di sisi kanan deskripsi set data terdapat kolom ID Gambar. Perhatikan bahwa ID gambar dalam contoh disalin dari ID gambar yang ditampilkan dalam deskripsi set data.

Alternatif untuk menyalin dan menempelkan ID gambar adalah menggunakan tombol Impor pada deskripsi set data atau link impor di sisi kanan hasil penelusuran. Jika Anda mengklik link atau tombol impor, variabel akan dibuat secara otomatis di bagian khusus, yang bernama 'Imports', di bagian atas skrip Anda. Anda dapat mengganti nama variabel dengan mengklik namanya di bagian impor.

Mengonfigurasi Peta

Bagian baru kedua dari contoh ini adalah panggilan Map.setCenter(). Metode ini pada objek Map, yang merepresentasikan tampilan Peta di Editor Kode, memusatkan peta pada garis bujur, garis lintang (dalam derajat desimal), dan tingkat zoom yang diberikan, dengan 1 adalah zoom out sehingga peta menampilkan seluruh permukaan Bumi. Angka yang lebih besar akan di-zoom dari sana. Temukan semua metode pada objek Map dengan memeriksa bagian Peta di tab Dokumen di sisi kiri Editor Kode.

Menambahkan lapisan ke Peta

Baris terakhir dalam contoh tersebut menyatakan: gunakan metode addLayer() objek Map untuk menambahkan gambar ke tampilan peta di Editor Kode.

Selamat! Anda telah membuat skrip Earth Engine pertama Anda. Di bagian berikutnya, Anda akan mempelajari cara membuat gambar tersebut terlihat sedikit lebih baik.

Digresi: Gambar di Earth Engine

Gambar di Earth Engine (lihat halaman ini untuk mengetahui detail selengkapnya) terdiri dari satu atau beberapa band. Setiap band dalam gambar memiliki nama, nilai piksel, resolusi piksel, dan proyeksinya sendiri. Seperti yang akan segera Anda ketahui, gambar SRTM memiliki satu band: 'elevation'.

Saat Anda menambahkan gambar ke peta menggunakan Map.addLayer(), Earth Engine perlu menentukan cara memetakan nilai dalam band gambar ke warna pada tampilan. Jika gambar single-band ditambahkan ke peta, secara default Earth Engine menampilkan band dalam skala abu-abu, dengan nilai minimum ditetapkan ke hitam, dan nilai maksimum ditetapkan ke putih. Jika Anda tidak menentukan nilai minimum dan maksimum, Earth Engine akan menggunakan nilai default. Misalnya, gambar yang baru saja Anda tambahkan ke peta ditampilkan sebagai gambar skala abu-abu yang direntangkan ke rentang data penuh, atau bilangan bulat 16-bit bertanda [-32768, 32767]. (Band float direntangkan ke [0, 1] dan band byte direntangkan ke [0, 255] secara default).

Anda dapat menemukan jenis data gambar dengan mencetaknya dan memeriksa objek gambar di tab Konsol. Misalnya, tempelkan kode berikut setelah kode sebelumnya:

Code Editor (JavaScript)

print('SRTM image', image);

Saat Anda mengklik jalankan, perhatikan bahwa sebuah objek muncul di konsol. Untuk menyelidiki properti objek, luaskan dengan mengklik zippy () di sebelah kiri objek atau properti. Luaskan objek gambar, properti 'bands', band 'elevation' di indeks '0', dan properti 'data_type' dari band 'elevation' untuk mengetahui bahwa jenis datanya adalah signed int16.

Menyesuaikan visualisasi lapisan

Untuk mengubah cara data direntangkan, Anda dapat memberikan parameter lain ke panggilan Map.addLayer(). Secara khusus, parameter kedua, visParams, memungkinkan Anda menentukan nilai minimum dan maksimum yang akan ditampilkan. Untuk mengetahui nilai yang akan digunakan, aktifkan tab Pemeriksa dan klik di sekitar peta untuk mendapatkan gambaran tentang rentang nilai piksel. Atau, gunakan Pengelola lapisan untuk meregangkan data secara interaktif, lalu amati nilai minimum dan maksimum yang sesuai dengan peregangan persentil atau standar deviasi. Misalkan melalui eksperimen tersebut, Anda menentukan bahwa data harus direntangkan ke [0, 3000]. Untuk menampilkan gambar menggunakan rentang ini, gunakan:

Code Editor (JavaScript)

Map.addLayer(image, {min: 0, max: 3000}, 'custom visualization');

Perhatikan bahwa parameter visParams adalah objek, dengan properti yang menentukan min dan max. (Pelajari lebih lanjut objek JavaScript dari tutorial JavaScript atau referensi eksternal ini). Perhatikan bahwa parameter ketiga untuk Map.addLayer() adalah nama lapisan yang ditampilkan di Pengelola lapisan. Hasilnya akan terlihat seperti Gambar 1. Arahkan kursor ke kotak Lapisan di sebelah kanan untuk melihat efek penggantian nama lapisan tersebut.

Tutorial_api_01_elevation.png
Gambar 1. Gambar elevasi sebagai skala abu-abu, direntangkan ke [0, 3000].

Untuk menampilkan satu band menggunakan palet warna, tambahkan properti palette ke objek visParams:

Code Editor (JavaScript)

Map.addLayer(image, {min: 0, max: 3000, palette: ['blue', 'green', 'red']},
    'custom palette');

Hasilnya akan terlihat seperti Gambar 2.

Tutorial_api_02_palette.png
Gambar 2. Gambar elevasi sebagai ramp warna dari biru ke merah, yang diregangkan ke [0, 3000].

Digresi: Palet

Palet memungkinkan Anda menetapkan skema warna untuk gambar satu band. Palet adalah daftar string warna yang dibatasi koma dan diinterpolasi secara linear antara nilai maksimum dan minimum dalam parameter visualisasi (atau default sesuai dengan jenis rentang, seperti yang dijelaskan sebelumnya). Misalnya, piksel yang kurang dari atau sama dengan nilai minimum akan ditampilkan dengan warna pertama dalam daftar; piksel yang lebih besar dari atau sama dengan nilai maksimum akan ditampilkan dengan warna terakhir dalam daftar. Warna perantara direntangkan secara linear ke nilai piksel perantara.

Warna ditentukan menggunakan skema nilai warna CSS standar web (lihat referensi eksternal ini untuk mempelajari lebih lanjut). Warna dapat ditentukan berdasarkan nama atau sebagai string heksadesimal yang menunjukkan kombinasi merah, hijau, dan biru. Nilai terendah di salah satu dari tiga posisi adalah 00 (mewakili angka desimal 0), sedangkan yang tertinggi adalah FF (mewakili angka desimal 255). String '000000' merepresentasikan warna hitam, 'FFFFFF' adalah putih, 'FF0000' adalah merah, '00FF00' adalah hijau, dan '0000FF' adalah biru. Lihat bagian Palet warna untuk mengetahui detail selengkapnya. Rentangan lainnya dapat dilakukan dengan menggunakan Deskriptor Lapisan Bergaya, seperti yang dijelaskan di bagian ini.

Nanti dalam tutorial ini, Anda akan mempelajari cara menampilkan gambar multi-band. Namun sebelumnya, buka halaman berikutnya untuk mempelajari cara melakukan komputasi dengan gambar.