Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.ImageCollection.first
Stay organized with collections
Save and categorize content based on your preferences.
Returns the first entry from a given collection.
| Usage | Returns | ImageCollection.first() | Image |
| Argument | Type | Details | this: imagecollection | ImageCollection | The ImageCollection instance. |
Examples
Code Editor (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 setup
See the
Python Environment page for information on the Python API and using
geemap for interactive development.
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)
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\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```"]]