ee.FeatureCollection.getDownloadURL

  • getDownloadURL retrieves a URL to download a FeatureCollection in various formats like CSV, JSON, GeoJSON, KML, and KMZ.

  • You can customize the download by selecting specific attributes using the selectors parameter and specifying a filename using the filename parameter.

  • By default, all feature properties are included in the download, and the output format is CSV if not explicitly defined.

  • The function can be used synchronously or asynchronously by providing an optional callback function.

Gets a download URL. When the URL is accessed, the FeatureCollection is downloaded in one of several formats.

Returns a download URL or undefined if a callback was specified.

UsageReturns
FeatureCollection.getDownloadURL(format, selectors, filename, callback)Object|String
ArgumentTypeDetails
this: featurecollectionFeatureCollectionThe FeatureCollection instance.
formatString, optionalThe format of download, one of: "csv", "json", "geojson", "kml", "kmz" ("json" outputs GeoJSON). If unspecified, defaults to "csv".
selectorsList<String>|String, optionalFeature property names used to select the attributes to be downloaded. If unspecified, all properties are included.
filenameString, optionalName of the file to be downloaded; extension is appended by default. If unspecified, defaults to "table".
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

Examples

Code Editor (JavaScript)

// FeatureCollection of power plants in Belgium.
var fc = ee.FeatureCollection('WRI/GPPD/power_plants')
            .filter('country_lg == "Belgium"');

// Get a download URL for the FeatureCollection.
var downloadUrl = fc.getDownloadURL({
  format: 'CSV',
  selectors: ['capacitymw', 'fuel1'],
  filename: 'belgian_power_plants'
});
print('URL for downloading FeatureCollection as CSV', downloadUrl);

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"')

# Get a download URL for the FeatureCollection.
download_url = fc.getDownloadURL(**{
  'filetype': 'CSV',
  'selectors': ['capacitymw', 'fuel1'],
  'filename': 'belgian_power_plants',
})
print('URL for downloading FeatureCollection as CSV:', download_url)