Earth Engine is introducing noncommercial quota tiers to safeguard shared compute resources and ensure reliable performance for everyone. All noncommercial projects will need to select a quota tier by April 27, 2026 or will use the Community Tier by default. Tier quotas will take effect for all projects (regardless of tier selection date) on April 27, 2026 . Learn more.

ee.Array.first

Page Summary

The Array.first method selects the value of the first element on an element-wise basis.
It takes a right-hand array or a single value as an argument and returns an Array.
Both the left-hand and right-hand values are expected to be Arrays.

On an element-wise basis, selects the value of the first value.

Usage	Returns
`Array. first (right)`	Array

Argument	Type	Details
this: `left`	Array	The left-hand value.
`right`	Array	The right-hand value.

Examples

Code Editor (JavaScript)

 var 
  
 empty 
  
 = 
  
 ee 
 . 
 Array 
 ([], 
  
 ee 
 . 
 PixelType 
 . 
 int8 
 ()); 
 print 
 ( 
 empty 
 . 
 first 
 ( 
 empty 
 )); 
  
 // [] 
 print 
 ( 
 ee 
 . 
 Array 
 ([ 
 0 
 ]). 
 first 
 ( 
 0 
 )); 
  
 // [0] 
 print 
 ( 
 ee 
 . 
 Array 
 ([ 
 0 
 , 
  
 1 
 , 
  
 2 
 ]). 
 first 
 ( 
 1 
 )); 
  
 // [0,1,2] 
 print 
 ( 
 ee 
 . 
 Array 
 ([ 
 0 
 , 
  
 1 
 , 
  
 2 
 ]). 
 first 
 ( 
 ee 
 . 
 Array 
 ([ 
 3 
 , 
  
 4 
 , 
  
 5 
 ]))); 
  
 // [0,1,2] 
 print 
 ( 
 ee 
 . 
 Array 
 ([ 
 3 
 , 
  
 4 
 , 
  
 5 
 ]). 
 first 
 ( 
 ee 
 . 
 Array 
 ([ 
 0 
 , 
  
 1 
 , 
  
 2 
 ]))); 
  
 // [3,4,5]

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)

 empty 
 = 
 ee 
 . 
 Array 
 ([], 
 ee 
 . 
 PixelType 
 . 
 int8 
 ()) 
 display 
 ( 
 empty 
 . 
 first 
 ( 
 empty 
 )) 
 # [] 
 display 
 ( 
 ee 
 . 
 Array 
 ([ 
 0 
 ]) 
 . 
 first 
 ( 
 0 
 )) 
 # [0] 
 display 
 ( 
 ee 
 . 
 Array 
 ([ 
 0 
 , 
 1 
 , 
 2 
 ]) 
 . 
 first 
 ( 
 1 
 )) 
 # [0,1,2] 
 display 
 ( 
 ee 
 . 
 Array 
 ([ 
 0 
 , 
 1 
 , 
 2 
 ]) 
 . 
 first 
 ( 
 ee 
 . 
 Array 
 ([ 
 3 
 , 
 4 
 , 
 5 
 ]))) 
 # [0, 1, 2] 
 display 
 ( 
 ee 
 . 
 Array 
 ([ 
 3 
 , 
 4 
 , 
 5 
 ]) 
 . 
 first 
 ( 
 ee 
 . 
 Array 
 ([ 
 0 
 , 
 1 
 , 
 2 
 ]))) 
 # [3, 4, 5]

ee.Array.first Stay organized with collections Save and categorize content based on your preferences.

Page Summary

Examples

Code Editor (JavaScript)

Colab (Python)

ee.Array.first