공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
ImageCollection 정보 및 메타데이터
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이미지와 마찬가지로 ImageCollection에 관한 정보를 얻는 방법에는 여러 가지가 있습니다. 컬렉션을 콘솔에 직접 출력할 수 있지만 콘솔 출력은 5,000개 요소로 제한됩니다. 이미지가 5,000개를 초과하는 컬렉션은 인쇄하기 전에 필터링해야 합니다. 따라서 대규모 컬렉션을 인쇄하는 속도가 느려집니다. 다음 예는 이미지 모음에 관한 정보를 프로그래매틱 방식으로 가져오는 다양한 방법을 보여줍니다.
코드 편집기 (JavaScript)
// Load a Landsat 8 ImageCollection for a single path-row.
var collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')
.filter(ee.Filter.eq('WRS_PATH', 44))
.filter(ee.Filter.eq('WRS_ROW', 34))
.filterDate('2014-03-01', '2014-08-01');
print('Collection: ', collection);
// Get the number of images.
var count = collection.size();
print('Count: ', count);
// Get the date range of images in the collection.
var range = collection.reduceColumns(ee.Reducer.minMax(), ['system:time_start'])
print('Date range: ', ee.Date(range.get('min')), ee.Date(range.get('max')))
// Get statistics for a property of the images in the collection.
var sunStats = collection.aggregate_stats('SUN_ELEVATION');
print('Sun elevation statistics: ', sunStats);
// Sort by a cloud cover property, get the least cloudy image.
var image = ee.Image(collection.sort('CLOUD_COVER').first());
print('Least cloudy image: ', image);
// Limit the collection to the 10 most recent images.
var recent = collection.sort('system:time_start', false).limit(10);
print('Recent images: ', recent);
Python 설정
Python API 및 대화형 개발을 위한 geemap 사용에 관한 자세한 내용은
Python 환경 페이지를 참고하세요.
import ee
import geemap.core as geemap
Colab (Python)
# Load a Landsat 8 ImageCollection for a single path-row.
collection = (
ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')
.filter(ee.Filter.eq('WRS_PATH', 44))
.filter(ee.Filter.eq('WRS_ROW', 34))
.filterDate('2014-03-01', '2014-08-01')
)
display('Collection:', collection)
# Get the number of images.
count = collection.size()
display('Count:', count)
# Get the date range of images in the collection.
range = collection.reduceColumns(ee.Reducer.minMax(), ['system:time_start'])
display('Date range:', ee.Date(range.get('min')), ee.Date(range.get('max')))
# Get statistics for a property of the images in the collection.
sun_stats = collection.aggregate_stats('SUN_ELEVATION')
display('Sun elevation statistics:', sun_stats)
# Sort by a cloud cover property, get the least cloudy image.
image = ee.Image(collection.sort('CLOUD_COVER').first())
display('Least cloudy image:', image)
# Limit the collection to the 10 most recent images.
recent = collection.sort('system:time_start', False).limit(10)
display('Recent images:', recent)
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThis guide demonstrates how to programmatically retrieve information from Earth Engine ImageCollections, such as size, date range, image properties, and specific images.\u003c/p\u003e\n"],["\u003cp\u003eYou can print an ImageCollection to the console, but for collections larger than 5000 images, filtering is necessary before printing to avoid slowdowns.\u003c/p\u003e\n"],["\u003cp\u003eExamples are provided using the JavaScript and Python APIs for tasks like filtering, sorting, getting statistics, and limiting the collection size.\u003c/p\u003e\n"],["\u003cp\u003eIt shows how to get specific images from the collection, including the least cloudy or the most recent ones, based on properties and sorting.\u003c/p\u003e\n"],["\u003cp\u003eThe code snippets are readily usable in Code Editor, Colab, or any Python environment set up for Earth Engine, with \u003ccode\u003egeemap\u003c/code\u003e suggested for interactive Python development.\u003c/p\u003e\n"]]],[],null,["# ImageCollection Information and Metadata\n\nAs with Images, there are a variety of ways to get information about an\n`ImageCollection`. The collection can be printed directly to the console,\nbut the console printout is limited to 5000 elements. Collections larger than 5000\nimages will need to be filtered before printing. Printing a large collection will be\ncorrespondingly slower. The following example shows various ways of getting information\nabout image collections programmatically:\n\n### Code Editor (JavaScript)\n\n```javascript\n// Load a Landsat 8 ImageCollection for a single path-row.\nvar collection = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')\n .filter(ee.Filter.eq('WRS_PATH', 44))\n .filter(ee.Filter.eq('WRS_ROW', 34))\n .filterDate('2014-03-01', '2014-08-01');\nprint('Collection: ', collection);\n\n// Get the number of images.\nvar count = collection.size();\nprint('Count: ', count);\n\n// Get the date range of images in the collection.\nvar range = collection.reduceColumns(ee.Reducer.minMax(), ['system:time_start'])\nprint('Date range: ', ee.Date(range.get('min')), ee.Date(range.get('max')))\n\n// Get statistics for a property of the images in the collection.\nvar sunStats = collection.aggregate_stats('SUN_ELEVATION');\nprint('Sun elevation statistics: ', sunStats);\n\n// Sort by a cloud cover property, get the least cloudy image.\nvar image = ee.Image(collection.sort('CLOUD_COVER').first());\nprint('Least cloudy image: ', image);\n\n// Limit the collection to the 10 most recent images.\nvar recent = collection.sort('system:time_start', false).limit(10);\nprint('Recent images: ', recent);\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\n# Load a Landsat 8 ImageCollection for a single path-row.\ncollection = (\n ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA')\n .filter(ee.Filter.eq('WRS_PATH', 44))\n .filter(ee.Filter.eq('WRS_ROW', 34))\n .filterDate('2014-03-01', '2014-08-01')\n)\ndisplay('Collection:', collection)\n\n# Get the number of images.\ncount = collection.size()\ndisplay('Count:', count)\n\n# Get the date range of images in the collection.\nrange = collection.reduceColumns(ee.Reducer.minMax(), ['system:time_start'])\ndisplay('Date range:', ee.Date(range.get('min')), ee.Date(range.get('max')))\n\n# Get statistics for a property of the images in the collection.\nsun_stats = collection.aggregate_stats('SUN_ELEVATION')\ndisplay('Sun elevation statistics:', sun_stats)\n\n# Sort by a cloud cover property, get the least cloudy image.\nimage = ee.Image(collection.sort('CLOUD_COVER').first())\ndisplay('Least cloudy image:', image)\n\n# Limit the collection to the 10 most recent images.\nrecent = collection.sort('system:time_start', False).limit(10)\ndisplay('Recent images:', recent)\n```"]]
