Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.FeatureCollection.toList
Stay organized with collections
Save and categorize content based on your preferences.
Returns the elements of a collection as a list.
| Usage | Returns | FeatureCollection.toList(count, offset) | List |
| Argument | Type | Details | this: collection | FeatureCollection | The input collection to fetch. |
count | Integer | The maximum number of elements to fetch. |
offset | Integer, default: 0 | The number of elements to discard from the start. If set, (offset + count) elements will be fetched and the first offset elements will be discarded. |
Examples
Code Editor (JavaScript)
// FeatureCollection of power plants in Belgium.
var fc = ee.FeatureCollection('WRI/GPPD/power_plants')
.filter('country_lg == "Belgium"');
print('First 5 features to an ee.List', fc.toList(5));
print('Second 5 features to an ee.List', fc.toList(5, 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)
# FeatureCollection of power plants in Belgium.
fc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(
'country_lg == "Belgium"')
print('First 5 features to an ee.List:', fc.toList(5).getInfo())
print('Second 5 features to an ee.List:', fc.toList(5, 5).getInfo())
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\u003e\u003ccode\u003etoList()\u003c/code\u003e converts an Earth Engine FeatureCollection into an Earth Engine List, enabling easier manipulation and analysis of its features.\u003c/p\u003e\n"],["\u003cp\u003eThis function can optionally limit the number of features fetched using the \u003ccode\u003ecount\u003c/code\u003e parameter and skip initial features using the \u003ccode\u003eoffset\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etoList()\u003c/code\u003e retrieves and displays the list of features from an input feature collection, offering flexibility for data extraction within a specific range or subset.\u003c/p\u003e\n"]]],[],null,["# ee.FeatureCollection.toList\n\nReturns the elements of a collection as a list.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------|---------|\n| FeatureCollection.toList`(count, `*offset*`)` | List |\n\n| Argument | Type | Details |\n|--------------------|---------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `collection` | FeatureCollection | The input collection to fetch. |\n| `count` | Integer | The maximum number of elements to fetch. |\n| `offset` | Integer, default: 0 | The number of elements to discard from the start. If set, (offset + count) elements will be fetched and the first offset elements will be discarded. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// FeatureCollection of power plants in Belgium.\nvar fc = ee.FeatureCollection('WRI/GPPD/power_plants')\n .filter('country_lg == \"Belgium\"');\n\nprint('First 5 features to an ee.List', fc.toList(5));\n\nprint('Second 5 features to an ee.List', fc.toList(5, 5));\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\n# FeatureCollection of power plants in Belgium.\nfc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(\n 'country_lg == \"Belgium\"')\n\nprint('First 5 features to an ee.List:', fc.toList(5).getInfo())\n\nprint('Second 5 features to an ee.List:', fc.toList(5, 5).getInfo())\n```"]]