공지사항 :
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 액세스 권한을 유지하기 위해
비상업용 자격 요건을 인증 해야 합니다. 2025년 9월 26일까지 인증하지 않으면 액세스가 보류될 수 있습니다.
의견 보내기
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
의견 보내기
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
의견을 전달하고 싶나요?
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-26(UTC)"],[],[]]