Ringkasan Gambar

Jalankan di Google Colab

Lihat sumber di GitHub

Seperti yang disebutkan dalam dokumen Memulai, data raster direpresentasikan sebagai objek Image di Earth Engine. Gambar terdiri dari satu atau beberapa band dan setiap band memiliki nama, jenis data, skala, mask, dan proyeksi sendiri. Setiap gambar memiliki metadata yang disimpan sebagai kumpulan properti.

Konstruktor ee.Image

Gambar dapat dimuat dengan menempelkan ID aset Earth Engine ke konstruktor ee.Image. Anda dapat menemukan ID gambar di katalog data. Misalnya, ke model elevasi digital (NASADEM):

Editor Kode (JavaScript)

var loadedImage = ee.Image('NASA/NASADEM_HGT/001');

Penyiapan Python

Lihat halaman Lingkungan Python untuk mengetahui informasi tentang Python API dan penggunaan geemap untuk pengembangan interaktif.

import ee
import geemap.core as geemap

Colab (Python)

loaded_image = ee.Image('NASA/NASADEM_HGT/001')

Perhatikan bahwa menemukan gambar melalui alat penelusuran Editor Kode sama saja. Saat Anda mengimpor aset, kode konstruksi gambar akan ditulis untuk Anda di bagian impor di Code Editor. Anda juga dapat menggunakan ID aset pribadi sebagai argumen untuk konstruktor ee.Image.

Mendapatkan ee.Image dari ee.ImageCollection

Cara standar untuk mendapatkan gambar dari koleksi adalah dengan memfilter koleksi, dengan filter dalam urutan penurunan kekhususan. Misalnya, untuk mendapatkan gambar dari koleksi pantulan permukaan Sentinel-2:

Editor Kode (JavaScript)

var first = ee.ImageCollection('COPERNICUS/S2_SR')
                .filterBounds(ee.Geometry.Point(-70.48, 43.3631))
                .filterDate('2019-01-01', '2019-12-31')
                .sort('CLOUDY_PIXEL_PERCENTAGE')
                .first();
Map.centerObject(first, 11);
Map.addLayer(first, {bands: ['B4', 'B3', 'B2'], min: 0, max: 2000}, 'first');

Penyiapan Python

Lihat halaman Lingkungan Python untuk mengetahui informasi tentang Python API dan penggunaan geemap untuk pengembangan interaktif.

import ee
import geemap.core as geemap

Colab (Python)

first = (
    ee.ImageCollection('COPERNICUS/S2_SR')
    .filterBounds(ee.Geometry.Point(-70.48, 43.3631))
    .filterDate('2019-01-01', '2019-12-31')
    .sort('CLOUDY_PIXEL_PERCENTAGE')
    .first()
)

# Define a map centered on southern Maine.
m = geemap.Map(center=[43.7516, -70.8155], zoom=11)

# Add the image layer to the map and display it.
m.add_layer(
    first, {'bands': ['B4', 'B3', 'B2'], 'min': 0, 'max': 2000}, 'first'
)
display(m)

Perhatikan bahwa pengurutan dilakukan setelah filter. Hindari pengurutan seluruh koleksi.

Gambar dari Cloud GeoTIFF

Anda dapat menggunakan ee.Image.loadGeoTIFF() untuk memuat gambar dari GeoTIFF yang Dioptimalkan Cloud di Google Cloud Storage. Misalnya, set data Landsat publik yang dihosting di Google Cloud berisi GeoTIFF ini, yang sesuai dengan band 5 dari scene Landsat 8. Anda dapat memuat gambar ini dari Cloud Storage menggunakan ee.Image.loadGeoTIFF():

Editor Kode (JavaScript)

var uri = 'gs://gcp-public-data-landsat/LC08/01/001/002/' +
    'LC08_L1GT_001002_20160817_20170322_01_T2/' +
    'LC08_L1GT_001002_20160817_20170322_01_T2_B5.TIF';
var cloudImage = ee.Image.loadGeoTIFF(uri);
print(cloudImage);

Penyiapan Python

Lihat halaman Lingkungan Python untuk mengetahui informasi tentang Python API dan penggunaan geemap untuk pengembangan interaktif.

import ee
import geemap.core as geemap

Colab (Python)

uri = (
    'gs://gcp-public-data-landsat/LC08/01/001/002/'
    + 'LC08_L1GT_001002_20160817_20170322_01_T2/'
    + 'LC08_L1GT_001002_20160817_20170322_01_T2_B5.TIF'
)
cloud_image = ee.Image.loadGeoTIFF(uri)
display(cloud_image)

Perhatikan bahwa jika Anda ingin memuat ulang GeoTIFF yang Dioptimalkan Cloud yang Anda ekspor dari Earth Engine ke Cloud Storage, saat melakukan ekspor, tetapkan cloudOptimized ke true seperti yang dijelaskan di sini.

Gambar dari array Zarr v2

Anda dapat menggunakan ee.Image.loadZarrV2Array() untuk memuat gambar dari array Zarr v2 di Google Cloud Storage. Misalnya, set data ERA5 publik yang dihosting di Google Cloud berisi array Zarr v2 ini, yang sesuai dengan meter air yang telah menguap dari permukaan Bumi. Anda dapat memuat array ini dari Cloud Storage menggunakan ee.Image.loadZarrV2Array():

Editor Kode (JavaScript)

var timeStart = 1000000;
var timeEnd = 1000010;
var zarrV2ArrayImage = ee.Image.loadZarrV2Array({
  uri:
      'gs://gcp-public-data-arco-era5/ar/full_37-1h-0p25deg-chunk-1.zarr-v3/evaporation/.zarray',
  proj: 'EPSG:4326',
  starts: [timeStart],
  ends: [timeEnd]
});
print(zarrV2ArrayImage);
Map.addLayer(zarrV2ArrayImage, {min: -0.0001, max: 0.00005}, 'Evaporation');

Penyiapan Python

Lihat halaman Lingkungan Python untuk mengetahui informasi tentang Python API dan penggunaan geemap untuk pengembangan interaktif.

import ee
import geemap.core as geemap

Colab (Python)

time_start = 1000000
time_end = 1000010
zarr_v2_array_image = ee.Image.loadZarrV2Array(
    uri='gs://gcp-public-data-arco-era5/ar/full_37-1h-0p25deg-chunk-1.zarr-v3/evaporation/.zarray',
    proj='EPSG:4326',
    starts=[time_start],
    ends=[time_end],
)

display(zarr_v2_array_image)

m.add_layer(
    zarr_v2_array_image, {'min': -0.0001, 'max': 0.00005}, 'Evaporation'
)
m

Gambar konstan

Selain memuat gambar berdasarkan ID, Anda juga dapat membuat gambar dari konstanta, daftar, atau objek Earth Engine lainnya yang sesuai. Berikut ini ilustrasi metode untuk membuat gambar, mendapatkan subset band, dan memanipulasi band:

Editor Kode (JavaScript)

// Create a constant image.
var image1 = ee.Image(1);
print(image1);

// Concatenate two images into one multi-band image.
var image2 = ee.Image(2);
var image3 = ee.Image.cat([image1, image2]);
print(image3);

// Create a multi-band image from a list of constants.
var multiband = ee.Image([1, 2, 3]);
print(multiband);

// Select and (optionally) rename bands.
var renamed = multiband.select(
    ['constant', 'constant_1', 'constant_2'], // old names
    ['band1', 'band2', 'band3']               // new names
);
print(renamed);

// Add bands to an image.
var image4 = image3.addBands(ee.Image(42));
print(image4);

Penyiapan Python

Lihat halaman Lingkungan Python untuk mengetahui informasi tentang Python API dan penggunaan geemap untuk pengembangan interaktif.

import ee
import geemap.core as geemap

Colab (Python)

# Create a constant image.
image_1 = ee.Image(1)
display(image_1)

# Concatenate two images into one multi-band image.
image_2 = ee.Image(2)
image_3 = ee.Image.cat([image_1, image_2])
display(image_3)

# Create a multi-band image from a list of constants.
multiband = ee.Image([1, 2, 3])
display(multiband)

# Select and (optionally) rename bands.
renamed = multiband.select(
    ['constant', 'constant_1', 'constant_2'],  # old names
    ['band1', 'band2', 'band3'],  # new names
)
display(renamed)

# Add bands to an image.
image_4 = image_3.addBands(ee.Image(42))
display(image_4)