公告:所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件,才能继续使用 Earth Engine。
ee.FeatureCollection.getDownloadURL
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
获取下载网址。当用户访问该网址时,系统会以多种格式之一下载 FeatureCollection。
返回下载网址;如果指定了回调,则返回 undefined。
用法 | 返回 |
---|
FeatureCollection.getDownloadURL(format, selectors, filename, callback) | 对象|字符串 |
参数 | 类型 | 详细信息 |
---|
此:featurecollection | FeatureCollection | FeatureCollection 实例。 |
format | 字符串,可选 | 下载格式,可以是以下值之一:“csv”“json”“geojson”“kml”“kmz”(“json”输出 GeoJSON)。如果未指定,则默认为“csv”。 |
selectors | List<String>|String,可选 | 用于选择要下载的属性的要素属性名称。如果未指定,则包含所有媒体资源。 |
filename | 字符串,可选 | 要下载的文件的名称;默认情况下,系统会附加扩展名。如果未指定,则默认为“表格”。 |
callback | 函数(可选) | 可选的回调。如果未提供,则会同步进行调用。 |
示例
代码编辑器 (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 设置
如需了解 Python API 和如何使用 geemap
进行交互式开发,请参阅
Python 环境页面。
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)
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003e\u003ccode\u003egetDownloadURL\u003c/code\u003e retrieves a URL to download a FeatureCollection in various formats like CSV, JSON, GeoJSON, KML, and KMZ.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize the download by selecting specific attributes using the \u003ccode\u003eselectors\u003c/code\u003e parameter and specifying a filename using the \u003ccode\u003efilename\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eBy default, all feature properties are included in the download, and the output format is CSV if not explicitly defined.\u003c/p\u003e\n"],["\u003cp\u003eThe function can be used synchronously or asynchronously by providing an optional callback function.\u003c/p\u003e\n"]]],["The `FeatureCollection.getDownloadURL` method generates a URL for downloading a FeatureCollection in various formats (CSV, JSON, GeoJSON, KML, KMZ). Users can specify the `format`, `selectors` (properties to include), and `filename`. If a `callback` function is used, the method returns `undefined`. If not, it will return the download URL synchronously. If format and filename are not specified, they default to CSV and \"table\" respectively, all properties are included.\n"],null,["# ee.FeatureCollection.getDownloadURL\n\n\u003cbr /\u003e\n\nGets a download URL. When the URL is accessed, the FeatureCollection is downloaded in one of several formats.\n\n\u003cbr /\u003e\n\nReturns a download URL or undefined if a callback was specified.\n\n| Usage | Returns |\n|----------------------------------------------------------------------------------------------|----------------|\n| FeatureCollection.getDownloadURL`(`*format* `, `*selectors* `, `*filename* `, `*callback*`)` | Object\\|String |\n\n| Argument | Type | Details |\n|---------------------------|----------------------------------|-------------------------------------------------------------------------------------------------------------------------------------|\n| this: `featurecollection` | FeatureCollection | The FeatureCollection instance. |\n| `format` | String, optional | The format of download, one of: \"csv\", \"json\", \"geojson\", \"kml\", \"kmz\" (\"json\" outputs GeoJSON). If unspecified, defaults to \"csv\". |\n| `selectors` | List\\\u003cString\\\u003e\\|String, optional | Feature property names used to select the attributes to be downloaded. If unspecified, all properties are included. |\n| `filename` | String, optional | Name of the file to be downloaded; extension is appended by default. If unspecified, defaults to \"table\". |\n| `callback` | Function, optional | An optional callback. If not supplied, the call is made synchronously. |\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\n// Get a download URL for the FeatureCollection.\nvar downloadUrl = fc.getDownloadURL({\n format: 'CSV',\n selectors: ['capacitymw', 'fuel1'],\n filename: 'belgian_power_plants'\n});\nprint('URL for downloading FeatureCollection as CSV', downloadUrl);\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\n# Get a download URL for the FeatureCollection.\ndownload_url = fc.getDownloadURL(**{\n 'filetype': 'CSV',\n 'selectors': ['capacitymw', 'fuel1'],\n 'filename': 'belgian_power_plants',\n})\nprint('URL for downloading FeatureCollection as CSV:', download_url)\n```"]]