Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain access. If you have not verified by September 26, 2025, your access may be on hold.
Stay organized with collections
Save and categorize content based on your preferences.
AI-generated Key Takeaways
The listImages function returns a list of images in an image collection.
The returned object includes an images array and an optional nextPageToken.
The function takes the image collection ID, optional parameters for filtering and pagination, and an optional callback function.
The optional parameters allow filtering by properties, time range, region, and controlling the level of detail returned.
Returns a list of the contents in an image collection, in an object that includes an images array and an optional nextPageToken.
Usage
Returns
ee.data.listImages(parent, params, callback)
ListImagesResponse
Argument
Type
Details
parent
String
The ID of the image collection to list.
params
Object, optional
An object containing optional request parameters with the following possible values:
pageSize (string) The number of results to return. If not specified, all results are returned.
pageToken (string) The token page of results to return.
startTime (ISO 8601 string) The minimum start time (inclusive).
endTime (ISO 8601 string) The maximum end time (exclusive).
region (GeoJSON or WKT string) A region to filter on.
properties (list of strings) A list of property filters to apply, for example:
["classification=urban", "size>=2"].
filter (string) An additional filter query to apply. Example query: properties.my_property>=1 AND properties.my_property<2 AND startTime >= "2019-01-01T00:00:00.000Z" AND endTime < "2020-01-01T00:00:00.000Z" AND intersects("{'type':'Point','coordinates':[0,0]}") See https://google.aip.dev/160 for how to construct a query.
view (string) Specifies how much detail is returned in the list. Either "FULL" (default) for all image properties or "BASIC".
[null,null,["Last updated 2024-06-05 UTC."],[],["The function `ee.data.listImages` retrieves a list of image collection contents. It requires a `parent` ID and optionally accepts `params` for filtering results, including `pageSize`, `pageToken`, time ranges (`startTime`, `endTime`), `region`, `properties`, and a custom `filter`. The `view` parameter controls the detail level returned. Results are returned in a `ListImagesResponse` object, which contains an `images` array and an optional `nextPageToken`. A `callback` function can be used for asynchronous calls.\n"]]