公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.ImageCollection.first
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
傳回指定集合的第一個項目。
| 用量 | 傳回 |
|---|
ImageCollection.first() | 圖片 |
| 引數 | 類型 | 詳細資料 |
|---|
這個：imagecollection | ImageCollection | ImageCollection 執行個體。 |
範例
程式碼編輯器 (JavaScript)
var image = ee.ImageCollection('COPERNICUS/S2_SR').first();
Map.centerObject(image, 8);
var vis = {bands: ['B4', 'B3', 'B2'], min: 0, max: 5000};
Map.addLayer(image, vis, 'first of S2_SR');
// Display the image metadata.
print(image);
Python 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
image = ee.ImageCollection('COPERNICUS/S2_SR').first()
m = geemap.Map()
m.center_object(image, 8)
vis = {'bands': ['B4', 'B3', 'B2'], 'min': 0, 'max': 5000}
m.add_layer(image, vis, 'first of S2_SR')
display(m)
# Display the image metadata.
display(image)
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eThe \u003ccode\u003efirst()\u003c/code\u003e function retrieves the first image from an ImageCollection in Earth Engine.\u003c/p\u003e\n"],["\u003cp\u003eIt can be applied to any ImageCollection, like the 'COPERNICUS/S2_SR' dataset shown in the examples.\u003c/p\u003e\n"],["\u003cp\u003eUsers can then visualize and analyze this single image, displaying its metadata or adding it as a layer to a map.\u003c/p\u003e\n"],["\u003cp\u003eThe provided code demonstrates using \u003ccode\u003efirst()\u003c/code\u003e in both JavaScript and Python environments within the Google Earth Engine Code Editor and Colab.\u003c/p\u003e\n"]]],["The provided content describes the `.first()` method for an ImageCollection, which retrieves the initial Image within that collection. In JavaScript and Python examples, it's demonstrated by selecting the first image from the 'COPERNICUS/S2_SR' ImageCollection. The code then centers the map on this image, sets visualization parameters, displays it on the map, and prints the image's metadata. This method only takes the ImageCollection instance as input.\n"],null,["# ee.ImageCollection.first\n\n\u003cbr /\u003e\n\nReturns the first entry from a given collection.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------|---------|\n| ImageCollection.first`()` | Image |\n\n| Argument | Type | Details |\n|-------------------------|-----------------|-------------------------------|\n| this: `imagecollection` | ImageCollection | The ImageCollection instance. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nvar image = ee.ImageCollection('COPERNICUS/S2_SR').first();\nMap.centerObject(image, 8);\nvar vis = {bands: ['B4', 'B3', 'B2'], min: 0, max: 5000};\nMap.addLayer(image, vis, 'first of S2_SR');\n\n// Display the image metadata.\nprint(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.ImageCollection('COPERNICUS/S2_SR').first()\nm = geemap.Map()\nm.center_object(image, 8)\nvis = {'bands': ['B4', 'B3', 'B2'], 'min': 0, 'max': 5000}\nm.add_layer(image, vis, 'first of S2_SR')\ndisplay(m)\n\n# Display the image metadata.\ndisplay(image)\n```"]]
