공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
ee.Image.reduceResolution
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
지정된 리듀서를 사용하여 각 출력 픽셀에 해당하는 모든 입력 픽셀을 결합하는 리프로젝션을 사용 설정합니다. 리듀서에 입력이 하나 있으면 컬렉션의 각 밴드에 별도로 적용됩니다. 그렇지 않으면 입력 이미지의 밴드 수와 동일한 수의 입력이 있어야 합니다.
리듀서 출력 이름은 출력 밴드의 이름을 결정합니다. 입력이 여러 개인 리듀서는 출력 이름을 직접 사용하고, 입력과 출력이 각각 하나인 리듀서는 입력 밴드 이름을 유지하며, 입력이 하나이고 출력이 여러 개인 리듀서는 출력 이름에 입력 밴드 이름을 접두사로 붙입니다 (예: '10_mean', '10_stdDev', '20_mean', '20_stdDev').
리듀서 입력 가중치는 입력 마스크와 입력 픽셀로 덮인 출력 픽셀의 비율의 곱입니다.
| 사용 | 반환 값 |
|---|
Image.reduceResolution(reducer, bestEffort, maxPixels) | 이미지 |
| 인수 | 유형 | 세부정보 |
|---|
다음과 같은 경우: image | 이미지 | 입력 이미지입니다. |
reducer | 감소기 | 픽셀을 결합하는 데 사용할 리듀서입니다. |
bestEffort | 불리언, 기본값: false | 기본 해상도로 입력을 사용하면 너무 많은 픽셀이 필요한 경우 작업이 성공할 수 있는 피라미드 수준에서 이미 감소된 입력 픽셀로 시작합니다. |
maxPixels | 정수, 기본값: 64 | 각 출력 픽셀에 대해 결합할 최대 입력 픽셀 수입니다. 이 값을 너무 크게 설정하면 메모리 부족 문제가 발생합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003eThis operation reprojects images using a reducer to combine input pixels for each output pixel, applying it per band or across bands based on reducer input.\u003c/p\u003e\n"],["\u003cp\u003eOutput band names are determined by the reducer's output names, sometimes preserving, prefixing, or directly using them.\u003c/p\u003e\n"],["\u003cp\u003eInput pixel weights are calculated using input mask and fractional output pixel coverage.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ereduceResolution\u003c/code\u003e method takes an image, reducer, and optional parameters for handling large operations, returning a reprojected image.\u003c/p\u003e\n"],["\u003cp\u003eOptional parameters \u003ccode\u003ebestEffort\u003c/code\u003e and \u003ccode\u003emaxPixels\u003c/code\u003e control memory usage and allow for processing large images by adjusting input resolution and pixel combination limits.\u003c/p\u003e\n"]]],[],null,["# ee.Image.reduceResolution\n\nEnables reprojection using the given reducer to combine all input pixels corresponding to each output pixel. If the reducer has a single input, it will be applied separately to each band of the collection; otherwise it must have the same number of inputs as the input image has bands.\n\n\u003cbr /\u003e\n\nThe reducer output names determine the names of the output bands: reducers with multiple inputs will use the output names directly, reducers with a single input and single output will preserve the input band names, and reducers with a single input and multiple outputs will prefix the output name with the input band name (e.g., '10_mean', '10_stdDev', '20_mean', '20_stdDev').\n\nReducer input weights will be the product of the input mask and the fraction of the output pixel covered by the input pixel.\n\n| Usage | Returns |\n|-------------------------------------------------------------------|---------|\n| Image.reduceResolution`(reducer, `*bestEffort* `, `*maxPixels*`)` | Image |\n\n| Argument | Type | Details |\n|---------------|-------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | The input image. |\n| `reducer` | Reducer | The reducer to apply to be used for combining pixels. |\n| `bestEffort` | Boolean, default: false | If using the input at its default resolution would require too many pixels, start with already-reduced input pixels from a pyramid level that allows the operation to succeed. |\n| `maxPixels` | Integer, default: 64 | The maximum number of input pixels to combine for each output pixel. Setting this too large will cause out-of-memory problems. |"]]
