ee.ImageCollection.first

  • The first() method returns the initial entry from an ImageCollection.

  • The method is part of the ImageCollection class and does not require any arguments.

  • The result of calling first() on an ImageCollection is an Image object.

  • Examples are provided for using ImageCollection.first() in both JavaScript and Python environments.

Returns the first entry from a given collection.

UsageReturns
ImageCollection.first()Image
ArgumentTypeDetails
this: imagecollectionImageCollectionThe 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)