ee.Image.clipToBoundsAndScale

Bir resmi Geometri sınırlarına göre kırpar ve kırpılan resmi belirli bir boyuta veya ölçeğe göre ölçeklendirir.

Dikkat: geometry bağımsız değişkeni olarak büyük veya karmaşık bir koleksiyon sağlamak, performansın düşmesine neden olabilir. Koleksiyonların geometrisini harmanlamak iyi ölçeklenmez. İstenen sonucu elde etmek için gereken en küçük koleksiyonu (veya geometriyi) kullanın.

Kullanım	İadeler
Image.clipToBoundsAndScale(geometry, width, height, maxDimension, scale)	Resim

Bağımsız Değişken	Tür	Ayrıntılar
bu: input	Resim	Kırpılacak ve ölçeklendirilecek resim.
geometry	Geometri, varsayılan: null	Resmi kırpılacak geometri. Resim, bu geometrinin resimdeki izdüşümünde sınırlayıcı kutuyla kırpılır.
width	Tam sayı, varsayılan: null	Resmin ölçekleneceği genişlik (piksel cinsinden). "height" ile birlikte sağlanmalıdır. "maxDimension" ve "scale" ile birlikte kullanılamaz.
height	Tam sayı, varsayılan: null	Resmin ölçekleneceği yükseklik (piksel cinsinden). "width" ile birlikte sağlanmalıdır. "maxDimension" ve "scale" ile birlikte kullanılamaz.
maxDimension	Tam sayı, varsayılan: null	Resmin ölçeğinin ayarlanacağı maksimum boyut (piksel cinsinden). "width", "height" ve "scale" ile özeldir.
scale	Ondalık sayı, varsayılan: null	Ölçek belirtilirse projeksiyon, belirtilen ölçek değeri resmin projeksiyonundaki nominal metre boyutuyla bölünerek ölçeklendirilir. "width", "height" ve "maxDimension" ile özeldir.

Örnekler

Kod Düzenleyici (JavaScript)

// A digital elevation model.
var dem = ee.Image('NASA/NASADEM_HGT/001');
var demVis = {bands: 'elevation', min: 0, max: 2000};
print('DEM', dem);
Map.setCenter(-121.38, 46.51, 8);
Map.addLayer(dem, demVis, 'DEM');

// Clip DEM by a single polygon geometry, specify width and height parameters.
var geom1 = ee.Geometry.BBox(-123.55, 46.61, -122.57, 46.98);
var demClip1 = dem.clipToBoundsAndScale({
  geometry: geom1,
  width: 20,  // pixels
  height: 10  // pixels
});
print('Clipped image retains metadata and band names', demClip1);
Map.addLayer(demClip1, demVis, 'Single geometry clip (width, height)');
Map.addLayer(geom1, {color: 'red'}, 'Single geometry (width, height)');

// Clip DEM by a single polygon geometry, specify maxDimension parameter.
var geom2 = ee.Geometry.BBox(-120.79, 46.58, -120.16, 46.81);
var demClip2 = dem.clipToBoundsAndScale({
  geometry: geom2,
  maxDimension: 5,  // pixels
});
Map.addLayer(demClip2, demVis, 'Single polygon clip (maxDimension)');
Map.addLayer(geom2, {color: 'yellow'}, 'Single polygon (maxDimension)');

// Clip DEM by a single polygon geometry, specify scale parameter.
var geom3 = ee.Geometry.BBox(-120.79, 46.18, -120.16, 46.41);
var demClip3 = dem.clipToBoundsAndScale({
  geometry: geom3,
  scale: 1e4,  // meters
});
Map.addLayer(demClip3, demVis, 'Single polygon clip (scale)');
Map.addLayer(geom3, {color: 'blue'}, 'Single polygon (scale)');

Python kurulumu

Python API'si ve etkileşimli geliştirme için geemap kullanımı hakkında bilgi edinmek üzere Python Ortamı sayfasına bakın.

import ee
import geemap.core as geemap

Colab (Python)

# A digital elevation model.
dem = ee.Image('NASA/NASADEM_HGT/001')
dem_vis = {'bands': 'elevation', 'min': 0, 'max': 2000}
display('DEM', dem)
m = geemap.Map()
m.set_center(-121.38, 46.51, 8)
m.add_layer(dem, dem_vis, 'DEM')

# Clip DEM by a single polygon geometry, specify width and height parameters.
geom_1 = ee.Geometry.BBox(-123.55, 46.61, -122.57, 46.98)
dem_clip_1 = dem.clipToBoundsAndScale(geometry=geom_1, width=20, height=10)
display('Clipped image retains metadata and band names', dem_clip_1)
m.add_layer(dem_clip_1, dem_vis, 'Single geometry clip (width, height)')
m.add_layer(geom_1, {'color': 'red'}, 'Single geometry (width, height)')

# Clip DEM by a single polygon geometry, specify maxDimension parameter.
geom_2 = ee.Geometry.BBox(-120.79, 46.58, -120.16, 46.81)
dem_clip_2 = dem.clipToBoundsAndScale(geometry=geom_2, maxDimension=5)
m.add_layer(dem_clip_2, dem_vis, 'Single polygon clip (maxDimension)')
m.add_layer(geom_2, {'color': 'yellow'}, 'Single polygon (maxDimension)')

# Clip DEM by a single polygon geometry, specify scale parameter.
geom_3 = ee.Geometry.BBox(-120.79, 46.18, -120.16, 46.41)
dem_clip_3 = dem.clipToBoundsAndScale(geometry=geom_3, scale=1e4)
m.add_layer(dem_clip_3, dem_vis, 'Single polygon clip (scale)')
m.add_layer(geom_3, {'color': 'blue'}, 'Single polygon (scale)')
m