ee.List.get

  • List.get() retrieves an element from an Earth Engine List object at a specified index.

  • Negative index values can be used to access elements from the end of the list, with -1 representing the last element.

  • The returned element's type is ambiguous and might require explicit casting to a specific Earth Engine type for further operations (e.g., converting to ee.Number to perform calculations).

  • Input indices can be integers, ee.Number objects, or other computed objects that evaluate to an integer.

 Returns the element at the specified position in list. A negative index counts backwards from the end of the list.

UsageReturns
List.get(index)Object
ArgumentTypeDetails
this: listList
indexInteger

Examples

Code Editor (JavaScript)

// An ee.List object.
var list = ee.List([5, 10, 15, 20, 25, 30]);

// Fetch elements at specified 0-based positions in the list.
print('The second element', list.get(1));
print('The fourth element', list.get(3));
print('The last element', list.get(-1));
print('The second to last element', list.get(-2));

// ee.Number and integer computed objects are valid inputs.
print('Computed object index input', list.get(list.get(0)));

// The result of ee.List.get is an ambiguous object type. You need to cast the
// result to the expected type to use it in subsequent instance methods. For
// example, if you are fetching a number and wish to add it to another number,
// you must cast the .get() result as an ee.Number.
print('Add fetched number to another number', ee.Number(list.get(1)).add(2));

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)

# An ee.List object.
ee_list = ee.List([5, 10, 15, 20, 25, 30])

# Fetch elements at specified 0-based positions in the list.
print('The second element:', ee_list.get(1).getInfo())
print('The fourth element:', ee_list.get(3).getInfo())
print('The last element:', ee_list.get(-1).getInfo())
print('The second to last element:', ee_list.get(-2).getInfo())

# ee.Number and integer computed objects are valid inputs.
print('Computed object index input:', ee_list.get(list.get(0)).getInfo())

# The result of ee.List.get is an ambiguous object type. You need to cast the
# result to the expected type to use it in subsequent instance methods. For
# example, if you are fetching a number and wish to add it to another number,
# you must cast the .get() result as an ee.Number.
print('Add fetched number to another number:',
      ee.Number(list.get(1)).add(2).getInfo())