API ini menyediakan akses yang sederhana dan seragam ke berbagai data gambar geospasial. Yang kami maksud dengan geospasial adalah data yang terkait dengan lokasi di permukaan Bumi. Yang dimaksud dengan data gambar adalah data yang disusun sebagai petak seragam nilai piksel, seperti gambar tradisional.
Contoh paling umum dari jenis data ini adalah citra satelit, seperti yang biasa dilihat pengguna di Google Maps dan Earth. Namun, banyak set data lain yang memiliki struktur yang sama, termasuk misalnya set data cuaca dan iklim yang dikotak-kotakkan, set data medan dan penutupan lahan, serta set data kepadatan populasi.
Autentikasi
Earth Engine API menggunakan protokol OAuth 2.0 untuk autentikasi dan otorisasi. Ada library praktis untuk menggunakan OAuth 2.0 guna mengeluarkan panggilan API dalam berbagai bahasa. Jika Anda belum pernah menggunakan OAuth 2.0 untuk mengakses Google API, sebaiknya Anda membaca dokumentasi tentang Menggunakan OAuth 2.0 untuk Mengakses Google API.
API ini menggunakan cakupan OAuth 2.0 Earth Engine https://www.googleapis.com/auth/earthengine.readonly. Jika Anda mengonfigurasi kredensial akun layanan sendiri, Anda harus meminta cakupan tersebut secara eksplisit. Jika Anda menggunakan kredensial aplikasi default yang tersedia di instance mesin virtual Compute Engine, Anda harus mengonfigurasi instance VM untuk meminta cakupan tersebut.
Aset
Inti dari model data Earth Engine adalah struktur aset yang mirip dengan sistem file. Ada tiga jenis aset utama, yang dijelaskan lebih mendetail di bawah: data raster geospasial itu sendiri disimpan dalam gambar, gambar dapat dikelompokkan ke dalam koleksi besar, dan gambar serta koleksi selanjutnya disusun dalam hierarki folder.
Misalnya, jalur berikut menjelaskan gambar Landsat tertentu:
LANDSAT/LC8_L1T/LC81180562013193LGN00
Dalam contoh ini, LANDSAT adalah folder tingkat teratas yang berisi semua data Landsat, LC8_L1T mengidentifikasi koleksi tertentu dari gambar Landsat 8 yang dikalibrasi dan dikoreksi medan, dan LC81180562013193LGN00 mengidentifikasi gambar tertentu dalam koleksi tersebut. Jalur aset dapat berisi huruf, angka, garis bawah, dan tanda hubung, yang dipisahkan oleh garis miring ke depan.
Setiap gambar memiliki metadata yang memudahkan identifikasi data yang diinginkan. Properti metadata per gambar ini biasanya mencakup:
- Geometri jejak gambar, seperti cakupan spasial gambar satelit atau set data medan.
- Stempel waktu gambar, seperti waktu pengambilan gambar satelit, atau hari atau bulan dalam set data model iklim.
- Properti nilai/kunci arbitrer, seperti perkiraan persentase tutupan awan pada gambar satelit Landsat.
Piksel dan Proyeksi Peta
Di Earth Engine, setiap gambar terdiri dari satu atau beberapa band data. Ini dapat sesuai dengan band merah, hijau, dan biru dari gambar satelit RGB biasa, atau dapat sesuai dengan sesuatu yang sama sekali berbeda, seperti suhu dan presipitasi dalam set data cuaca. Piksel di setiap rentang memiliki jenis data tertentu, misalnya uint8 atau float32.
Piksel dalam petak piksel sesuai dengan titik-titik di permukaan Bumi melalui fungsi matematika yang dikenal sebagai proyeksi peta. Hubungan ini biasanya memiliki dua komponen. Pertama, sistem referensi koordinat (CRS) menentukan koordinat 2D yang merepresentasikan titik di permukaan Bumi yang melengkung. Sistem referensi koordinat yang berbeda memiliki properti yang berbeda yang membuatnya sesuai untuk digunakan dengan berbagai jenis data dalam berbagai aplikasi. Sistem referensi koordinat biasanya diidentifikasi menggunakan kode ID standar; contoh umumnya adalah koordinat equirectangular, web Mercator, dan UTM.
Koordinat piksel kemudian biasanya terkait dengan sistem referensi koordinat spasial melalui transformasi affine yang mengontrol skala fisik dan asal grid piksel. Di Earth Engine, kami menyimpan piramida data untuk setiap gambar: tingkat dasar piramida berisi data asli dalam resolusi aslinya, dan tingkat yang lebih tinggi dari piramida menyimpan data ringkasan dengan resolusi yang lebih rendah. Level piramida ini dijelaskan oleh transformasi affine yang skalanya berbeda dengan faktor dua berturut-turut.
Koleksi dan Folder
Gambar sering kali berupa kumpulan data yang besar, seperti kumpulan semua gambar yang diambil oleh satelit tertentu, atau kumpulan estimasi suhu global dari waktu ke waktu. Earth Engine membuat indeks metadata yang memungkinkan Anda memfilter atau membuat kueri gambar dalam koleksi berdasarkan metadatanya, termasuk memfilter berdasarkan lokasi dan waktu. Biasanya, semua gambar dalam satu koleksi memiliki struktur yang sama, yaitu band yang sama dan properti metadata yang sama.
Gambar dan koleksi itu sendiri disusun menjadi hierarki folder. Folder sangat mirip dengan folder atau direktori biasa dalam sistem file tradisional: folder adalah penampung sederhana untuk aset lain, yaitu untuk gambar, koleksi, dan folder lainnya. Tidak semua gambar terdapat dalam koleksi: beberapa set data, seperti model medan global tertentu, mungkin hanya terdiri dari satu gambar. Terlepas dari itu, setiap aset diidentifikasi secara unik oleh jalur tertentu yang mengidentifikasi lokasinya di katalog data Earth Engine.