Earth Engine에서 얻은 과학적 결과를 해석하려면 Earth Engine에서 크기를 처리하는 방식을 이해하는 것이 중요합니다. 여기서 크기는 픽셀 해상도를 의미합니다. 다른 GIS 및 이미지 처리 플랫폼과 달리 분석 규모는 입력이 아닌 출력에서 결정됩니다. 특히 결과, 표시할 이미지 또는 통계를 요청할 때 데이터가 분석에 입력되는 크기를 지정합니다. 이 개념은 그림 1에 설명되어 있습니다.
그림 1. Earth Engine의 이미지 데이터 세트를 그래픽으로 표현한 것입니다.
점선은 4픽셀의 2x2 블록을 집계하기 위한 피라미드화 정책을 나타냅니다. Earth Engine은 출력에서 지정된 배율을 사용하여 입력으로 사용할 적절한 이미지 피라미드 수준을 결정합니다.
이미지 피라미드
Earth Engine의 이미지 애셋은 여러 크기의 이미지 피라미드로 존재합니다.
피라미딩 정책 (그림 1의 파선으로 표시됨)은 피라미드의 지정된 수준에서 각 픽셀이 다음 하위 수준의 2x2 픽셀 블록 집계에서 계산되는 방식을 결정합니다. 연속 값 이미지의 경우 피라미드 상위 수준의 픽셀 값은 다음 하위 수준의 픽셀 평균입니다. 불연속 값 이미지의 경우 피라미드 상위 수준의 픽셀 값은 다음 하위 수준의 픽셀 샘플 (일반적으로 왼쪽 상단 픽셀)입니다.
이미지 피라미드의 최하위 수준은 이미지 데이터가 Earth Engine으로 처리될 때의 기본 해상도 이미지 데이터를 나타냅니다. 처리 중에 데이터는 피라미드 정책에 따라 집계되어 상위 피라미드 수준을 만듭니다. 전체 이미지가 256x256픽셀 타일에 들어갈 때까지 데이터가 집계됩니다. 코드에서 이미지를 사용하면 Earth Engine은 분석에서 지정한 크기보다 작거나 같은 가장 가까운 크기의 피라미드 수준을 선택하고 필요에 따라 리샘플링합니다 (기본적으로 가장 가까운 이웃 사용).
분석 규모
Earth Engine의 분석 규모는 '가져오기' 기준으로 결정됩니다. 계산에 입력을 요청하는 규모는 출력에서 결정됩니다. 예를 들어 Code Editor 또는 geemap 지도 요소에 이미지를 추가하면 지도의 확대/축소 수준에 따라 이미지 피라미드에서 입력이 요청되는 배율이 결정됩니다. 다른 계산의 경우 scale를 인수로 지정합니다. 예를 들어 원래 해상도가 30m인 Landsat 이미지의 NIR 밴드를 사용합니다.
이 예에서 일정한 위치 (이미지 중심점)의 픽셀 값은 크기에 따라 달라집니다. 이는 규모에 따라 피라미드 수준이 다르게 선택되기 때문입니다. 비슷한 크기의 경우 최근접 이웃 리샘플링을 하면 동일한 픽셀 값이 반환됩니다. 중요한 점은 크기를 변경하면 다른 이미지 입력이 요청된다는 것입니다.
이미지를 지도에 추가하여 시각화하면 Earth Engine에서 확대/축소 수준에서 축척을 결정합니다. Landsat 이미지를 표시하는 간단한 예를 살펴보겠습니다.
지도에서 기본 해상도 픽셀이 선명하게 보일 수 있도록 최대한 확대된 상태로 시작됩니다. 충분히 축소하면 동일한 픽셀이 표시되지 않고 대신 이미지 피라미드의 상위 수준이 표시됩니다. 또한 Code Editor 및 geemap 지도에서는 지도 메르카토르 (EPSG:3857) 도법을 사용하므로 표시하기 전에 적절한 수준의 이미지 피라미드도 다시 투영해야 합니다. 프로젝션 문서에서 Earth Engine이 프로젝션을 처리하는 방법을 자세히 알아보세요.
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eIn Earth Engine, the scale of analysis, referring to pixel resolution, is determined by the output rather than the input, unlike other GIS platforms.\u003c/p\u003e\n"],["\u003cp\u003eEarth Engine utilizes image pyramids, where each level represents the image at a different scale, with pixel values aggregated from lower levels.\u003c/p\u003e\n"],["\u003cp\u003eThe scale you specify in your analysis dictates which level of the image pyramid Earth Engine uses as input, influencing the results you obtain.\u003c/p\u003e\n"],["\u003cp\u003eWhen visualizing images on the map, the zoom level determines the scale, and Earth Engine automatically selects the appropriate pyramid level for display.\u003c/p\u003e\n"],["\u003cp\u003eTo ensure consistent and accurate results, it's crucial to explicitly specify the desired scale when using functions with a scale parameter in Earth Engine.\u003c/p\u003e\n"]]],[],null,["# Scale\n\nUnderstanding how Earth Engine handles scale is crucial to interpreting scientific\nresults obtained from Earth Engine. Here, scale means pixel resolution. Unlike other\nGIS and image processing platforms, the scale of analysis is determined from the output,\nrather than the input. Specifically, when you make a request for results, an image to\ndisplay or a statistic, for example, you specify the scale at which data is input to the\nanalysis. This concept is illustrated in Figure 1.\nFigure 1. A graphic representation of an image dataset in Earth Engine. Dashed lines represent the pyramiding policy for aggregating 2x2 blocks of 4 pixels. Earth Engine uses the scale specified by the output to determine the appropriate level of the image pyramid to use as input.\n\nImage Pyramids\n--------------\n\nImage assets in Earth Engine exist at multiple scales, in\n[image pyramids](https://en.wikipedia.org/wiki/Pyramid_(image_processing)).\nThe pyramiding policy (represented by dashed lines in Figure 1) determines how each pixel\nat a given level of the pyramid is computed from the aggregation of a 2x2 block of pixels\nat the next lower level. For continuous valued images, the pixel values of upper levels of\nthe pyramid are the mean of pixels at the next lower level. For discrete valued images,\npixel values of upper levels of the pyramid are a sample (usually the top left pixel) of\npixels at the next lower level.\n\nThe lowest level of the image pyramid represents image data at native resolution, when it is\ningested into Earth Engine. During ingestion, the data are aggregated (according to the\npyramiding policy) to create higher pyramid levels. The data are aggregated until the\nentire image fits within a 256x256 pixel tile. When you use an image in your code,\nEarth Engine chooses a level of the pyramid with the closest scale less than or equal to\nthe scale specified by your analysis and resamples (using nearest neighbor by default)\nas necessary.\n\nScale of analysis\n-----------------\n\nScale of analysis in Earth Engine is determined on a \"pull\" basis. The scale at which\nto request inputs to a computation is determined from the output. For example, if you\nadd an image to the Code Editor or geemap map element, the zoom level of the map determines\nthe scale at which inputs are requested from the image pyramid. For other computations, you\nspecify `scale` as an argument. For example, using the NIR band of a Landsat\nimage, which has 30 meters native resolution:\n\n### Code Editor (JavaScript)\n\n```javascript\nvar image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318').select('B4');\n\nvar printAtScale = function(scale) {\n print('Pixel value at '+scale+' meters scale',\n image.reduceRegion({\n reducer: ee.Reducer.first(),\n geometry: image.geometry().centroid(),\n // The scale determines the pyramid level from which to pull the input\n scale: scale\n }).get('B4'));\n};\n\nprintAtScale(10); // 0.10394100844860077\nprintAtScale(30); // 0.10394100844860077\nprintAtScale(50); // 0.09130698442459106\nprintAtScale(70); // 0.1150854229927063\nprintAtScale(200); // 0.102478988468647\nprintAtScale(500); // 0.09072770178318024\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\nimage = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318').select('B4')\n\n\ndef print_at_scale(scale):\n display(\n f'Pixel value at {scale} meters scale',\n image.reduceRegion(\n reducer=ee.Reducer.first(),\n geometry=image.geometry().centroid(),\n # The scale determines the pyramid level from which to pull the input\n scale=scale,\n ).get('B4'),\n )\n\n\nprint_at_scale(10) # 0.10394100844860077\nprint_at_scale(30) # 0.10394100844860077\nprint_at_scale(50) # 0.09130698442459106\nprint_at_scale(70) # 0.1150854229927063\nprint_at_scale(200) # 0.102478988468647\nprint_at_scale(500) # 0.09072770178318024\n```\n\nIn this example, note that the pixel value at a constant location (the image centroid)\nvaries based on scale. This is due to the fact that different pyramid levels are selected\nfor different scales. For similar scales, nearest neighbor resampling results in the same\npixel value being returned. The important point is that by varying the scale, different\nimage inputs are requested.\n| **Note:** To avoid ambiguity, always specify scale when you use a function which has a scale parameter.\n\nWhen you visualize an image by adding it to the map, Earth Engine determines scale from\nthe zoom level. Consider the following simple example, which simply displays a Landsat\nimage:\n\n### Code Editor (JavaScript)\n\n```javascript\nvar image = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318');\nMap.centerObject(image, 17);\nMap.addLayer(image, {bands: ['B4', 'B3', 'B2'], max: 0.35}, 'image');\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\nimage = ee.Image('LANDSAT/LC08/C02/T1_TOA/LC08_044034_20140318')\nm = geemap.Map()\nm.center_object(image, 17)\nm.add_layer(image, {'bands': ['B4', 'B3', 'B2'], 'max': 0.35}, 'image')\nm\n```\n\nThe map starts zoomed all the way in, such that the native resolution pixels are clearly\nvisible. Zooming out far enough will not display the same pixels, but will instead\ndisplay higher levels of the image pyramid. It is also worth noting that the Code Editor\nand geemap maps use the [maps mercator (EPSG:3857)](http://epsg.io/3857)\nprojection, so the appropriate level of the image pyramid also needs to be reprojected prior\nto display. Learn more about how Earth Engine handles projections from the\n[projections doc](/earth-engine/guides/projections)."]]
