ee.Image.clipToBoundsAndScale

이미지를 Geometry의 경계로 클리핑하고 클리핑된 이미지를 특정 크기 또는 비율로 조정합니다.

주의: 크거나 복잡한 컬렉션을 geometry 인수로 제공하면 성능이 저하될 수 있습니다. 컬렉션의 지오메트리를 병합하는 것은 확장성이 좋지 않습니다. 원하는 결과를 얻는 데 필요한 가장 작은 컬렉션 (또는 지오메트리)을 사용하세요.

사용	반환 값
Image.clipToBoundsAndScale(geometry, width, height, maxDimension, scale)	이미지

인수	유형	세부정보
다음과 같은 경우: input	이미지	클립하고 크기를 조정할 이미지입니다.
geometry	기하학, 기본값: null	이미지를 클리핑할 형상입니다. 이미지는 이 형상의 이미지 투영에서 경계 상자로 클리핑됩니다.
width	정수, 기본값: null	이미지를 확장할 너비(픽셀)입니다. 'height'와 함께 제공해야 합니다. 'maxDimension' 및 'scale'과 함께 사용할 수 없습니다.
height	정수, 기본값: null	이미지를 조정할 높이(픽셀)입니다. 'width'와 함께 제공해야 합니다. 'maxDimension' 및 'scale'과 함께 사용할 수 없습니다.
maxDimension	정수, 기본값: null	이미지를 조정할 최대 크기(픽셀)입니다. 'width', 'height', 'scale'과 함께 사용할 수 없습니다.
scale	부동 소수점 수, 기본값: null	크기가 지정되면 이미지의 투영에서 지정된 크기 값을 미터의 명목상 크기로 나누어 투영의 크기가 조정됩니다. 'width', 'height', 'maxDimension'과 함께 사용할 수 없습니다.

예

코드 편집기 (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 설정

Python API 및 geemap를 사용한 대화형 개발에 관한 자세한 내용은 Python 환경 페이지를 참고하세요.

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