공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 액세스 권한을 유지하기 위해
비상업용 자격 요건을 인증해야 합니다. 2025년 9월 26일까지 인증하지 않으면 액세스가 보류될 수 있습니다.
ee.Image.sampleRectangle
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이미지에서 픽셀의 직사각형 영역을 밴드별 ND 배열로 추출합니다. 배열은 이미지와 동일한 속성을 유지하는 기능과 이미지를 샘플링하는 데 사용된 것과 동일한 형상 (지정되지 않은 경우 이미지 설치 공간)으로 반환됩니다. 각 밴드는 입력 투영에서 샘플링되며, 지오메트리가 지정되지 않은 경우 설치 공간을 사용하여 샘플링됩니다. 스칼라 밴드의 경우 출력 배열은 2D입니다. 배열 밴드의 경우 출력 배열은 (2+N)D이며 여기서 N은 원래 밴드의 차원 수입니다. 배열 밴드를 샘플링하는 경우 모든 배열의 요소 수가 동일해야 합니다. 밴드의 샘플링된 영역이 완전히 마스크 처리되고 기본 배열 값이 지정된 경우 이미지를 샘플링하는 대신 기본 배열 값이 사용됩니다.
| 사용 | 반환 값 |
|---|
Image.sampleRectangle(region, properties, defaultValue, defaultArrayValue) | 기능 |
| 인수 | 유형 | 세부정보 |
|---|
다음과 같은 경우: image | 이미지 | 샘플링할 이미지입니다. |
region | 기하학, 기본값: null | 투영된 경계 상자가 이미지를 샘플링하는 데 사용되는 리전입니다. 기본값은 각 대역의 설치 공간입니다. |
properties | 목록, 기본값: null | 샘플링된 이미지에서 복사할 속성입니다. 기본값은 모든 비시스템 속성입니다. |
defaultValue | 부동 소수점 수, 기본값: null | 샘플링된 픽셀이 마스크 처리되거나 밴드의 설치 공간 외부에 있을 때 사용되는 기본값입니다. |
defaultArrayValue | 배열, 기본값: null | 샘플링된 배열 픽셀이 마스크 처리되거나 대역의 설치 공간 외부에 있을 때 사용되는 기본값입니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[],["It extracts a rectangular pixel region from an image into an ND array per band, returning a feature with the same properties and geometry as the input. Bands are sampled in their input projection using a specified region or the image footprint. Output arrays are 2D for scalar bands and (2+N)D for array bands. If a sampled region is entirely masked, a specified default value or array is used. Properties from the image can be copied.\n"]]