ee.List

  • The ee.List(list) function constructs a new list in Earth Engine.

  • The function takes a list of objects or a computed object as an argument and returns a List.

  • Examples in both JavaScript and Python demonstrate the usage of ee.List with various data types, including empty lists, null, booleans, numbers, strings, and nested lists.

Constructs a new list.

UsageReturns
ee.List(list)List
ArgumentTypeDetails
listList<Object>|ObjectA list or a computed object.

Examples

Code Editor (JavaScript)

print(ee.List([]));  // []
print(ee.List([null]));  // [null]
print(ee.List([true]));  // [true]
print(ee.List([1]));  // [1]
print(ee.List([ee.Number(1)]));  // [1]
print(ee.List(['a']));  // ["a"]
print(ee.List([[]]));  // [[]]
print(ee.List([ee.List([])]));  // [[]]
print(ee.List([[], [[]], [1, [], 'a']]));  // [[],[[]],[1,[],"a"]]

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)

print(ee.List([]).getInfo())  # []
print(ee.List([None]).getInfo())  # [None]
print(ee.List([True]).getInfo())  # [True]
print(ee.List([1]).getInfo())  # [1]
print(ee.List([ee.Number(1)]).getInfo())  # [1]
print(ee.List(['a']).getInfo())  # ['a']
print(ee.List([[]]).getInfo())  # [[]]
print(ee.List([ee.List([])]).getInfo())  # [[]]
print(ee.List([[], [[]], [1, [], 'a']]).getInfo())  # [[], [[]], [1, [], 'a']]