Announcement: All noncommercial projects registered to use Earth Engine beforeApril 15, 2025 mustverify noncommercial eligibility to maintain access. If you have not verified by September 26, 2025, your access may be on hold.

ee.data.listImages

  • ThelistImages function returns a list of images in an image collection.

  • The returned object includes animages array and an optionalnextPageToken.

  • 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 animages array and an optionalnextPageToken.

UsageReturns
ee.data.listImages(parent,params,callback)ListImagesResponse
ArgumentTypeDetails
parentStringThe ID of the image collection to list.
paramsObject, optionalAn 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".
callbackFunction, optionalIf not supplied, the call is made synchronously.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2024-06-05 UTC.