公告:所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件,才能继续使用 Earth Engine。
ee.FeatureCollection
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
可使用以下实参构建 FeatureCollection:
- 字符串:假定为集合的名称。
- 单个几何图形。
- 单个功能。
- 功能列表。
- GeoJSON FeatureCollection
- 计算对象:重新解释为集合。
用法 | 返回 |
---|
ee.FeatureCollection(args, column) | FeatureCollection |
参数 | 类型 | 详细信息 |
---|
args | ComputedObject|Feature|FeatureCollection|Geometry|List<Object>|Number|String | 构造函数实参。 |
column | 字符串,可选 | 要使用的几何列的名称。仅在处理命名集合时有用。 |
示例
代码编辑器 (JavaScript)
// FeatureCollection from a string (collection name). Note that this only works
// with client-side strings, it won't accept computed, server-side strings.
var collectionName = 'WRI/GPPD/power_plants';
var collectionNameFc = ee.FeatureCollection(collectionName);
print('FeatureCollection from a string', collectionNameFc.limit(5));
// FeatureCollection from a single geometry.
var singleGeometry = ee.Geometry.Point(-62.54, -27.32);
var singleGeometryFc = ee.FeatureCollection(singleGeometry);
print('FeatureCollection from a single geometry', singleGeometryFc);
// FeatureCollection from a single feature.
var singleFeature = ee.Feature(ee.Geometry.Point(-62.54, -27.32), {key: 'val'});
var singleFeatureFc = ee.FeatureCollection(singleFeature);
print('FeatureCollection from a single feature', singleFeatureFc);
// FeatureCollection from a list of features.
var listOfFeatures = [
ee.Feature(ee.Geometry.Point(-62.54, -27.32), {key: 'val1'}),
ee.Feature(ee.Geometry.Point(-69.18, -10.64), {key: 'val2'}),
ee.Feature(ee.Geometry.Point(-45.98, -18.09), {key: 'val3'})
];
var listOfFeaturesFc = ee.FeatureCollection(listOfFeatures);
print('FeatureCollection from a list of features', listOfFeaturesFc);
// FeatureCollection from GeoJSON.
var geojson = {
"type": "FeatureCollection",
"columns": {
"key": "String",
"system:index": "String"
},
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
-62.54,
-27.32
]
},
"id": "0",
"properties": {
"key": "val1"
}
}
]
};
var geojsonFc = ee.FeatureCollection(geojson);
print('FeatureCollection from GeoJSON', geojsonFc);
Python 设置
如需了解 Python API 和如何使用 geemap
进行交互式开发,请参阅
Python 环境页面。
import ee
import geemap.core as geemap
Colab (Python)
# FeatureCollection from a string (collection name). Note that this only works
# with client-side strings, it won't accept computed, server-side strings.
collection_name = 'WRI/GPPD/power_plants'
collection_name_fc = ee.FeatureCollection(collection_name)
print('FeatureCollection from a string:', collection_name_fc.limit(5).getInfo())
# FeatureCollection from a single geometry.
single_geometry = ee.Geometry.Point(-62.54, -27.32)
single_geometry_fc = ee.FeatureCollection(single_geometry)
print('FeatureCollection from a single geometry:', single_geometry_fc.getInfo())
# FeatureCollection from a single feature.
single_feature = ee.Feature(ee.Geometry.Point(-62.54, -27.32), {'key': 'val'})
single_feature_fc = ee.FeatureCollection(single_feature)
print('FeatureCollection from a single feature:', single_feature_fc.getInfo())
# FeatureCollection from a list of features.
list_of_features = [
ee.Feature(ee.Geometry.Point(-62.54, -27.32), {'key': 'val1'}),
ee.Feature(ee.Geometry.Point(-69.18, -10.64), {'key': 'val2'}),
ee.Feature(ee.Geometry.Point(-45.98, -18.09), {'key': 'val3'})
]
list_of_features_fc = ee.FeatureCollection(list_of_features)
print('FeatureCollection from a list of features:',
list_of_features_fc.getInfo())
# FeatureCollection from GeoJSON.
geojson = {
'type': 'FeatureCollection',
'columns': {
'key': 'String',
'system:index': 'String'
},
'features': [
{
'type': 'Feature',
'geometry': {
'type': 'Point',
'coordinates': [
-62.54,
-27.32
]
},
'id': '0',
'properties': {
'key': 'val1'
}
}
]
}
geojson_fc = ee.FeatureCollection(geojson)
print('FeatureCollection from GeoJSON:', geojson_fc.getInfo())
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003e\u003ccode\u003eee.FeatureCollection\u003c/code\u003e can be constructed from a variety of inputs, including a string representing a collection name, a single geometry, a single feature, a list of features, a GeoJSON FeatureCollection, or a computed object.\u003c/p\u003e\n"],["\u003cp\u003eWhen constructed from a string, the string is assumed to be the name of a collection, however this only works with client-side strings and won't accept server-side, computed strings.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the optional \u003ccode\u003ecolumn\u003c/code\u003e argument to specify the geometry column when working with a named collection.\u003c/p\u003e\n"],["\u003cp\u003eExample code snippets are provided for both JavaScript and Python to illustrate how to create \u003ccode\u003eee.FeatureCollection\u003c/code\u003e instances from different types of input.\u003c/p\u003e\n"]]],["`FeatureCollection` is created using various inputs: a collection name (string), a single geometry, a single feature, a list of features, or a GeoJSON FeatureCollection. It can also be created from a computed object. `ee.FeatureCollection()` takes these arguments, with an optional `column` parameter for named collections. The function returns a `FeatureCollection`. Examples show the construction in JavaScript and Python using various sources and display the results.\n"],null,["# ee.FeatureCollection\n\n\u003cbr /\u003e\n\nFeatureCollections can be constructed from the following arguments:\n\n\u003cbr /\u003e\n\n- A string: assumed to be the name of a collection.\n\n- A single geometry.\n\n- A single feature.\n\n- A list of features.\n\n- A GeoJSON FeatureCollection\n\n- A computed object: reinterpreted as a collection.\n\n| Usage | Returns |\n|------------------------------------------|-------------------|\n| `ee.FeatureCollection(args, `*column*`)` | FeatureCollection |\n\n| Argument | Type | Details |\n|----------|--------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------|\n| `args` | ComputedObject\\|Feature\\|FeatureCollection\\|Geometry\\|List\\\u003cObject\\\u003e\\|Number\\|String | The constructor arguments. |\n| `column` | String, optional | The name of the geometry column to use. Only useful when working with a named collection. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// FeatureCollection from a string (collection name). Note that this only works\n// with client-side strings, it won't accept computed, server-side strings.\nvar collectionName = 'WRI/GPPD/power_plants';\nvar collectionNameFc = ee.FeatureCollection(collectionName);\nprint('FeatureCollection from a string', collectionNameFc.limit(5));\n\n// FeatureCollection from a single geometry.\nvar singleGeometry = ee.Geometry.Point(-62.54, -27.32);\nvar singleGeometryFc = ee.FeatureCollection(singleGeometry);\nprint('FeatureCollection from a single geometry', singleGeometryFc);\n\n// FeatureCollection from a single feature.\nvar singleFeature = ee.Feature(ee.Geometry.Point(-62.54, -27.32), {key: 'val'});\nvar singleFeatureFc = ee.FeatureCollection(singleFeature);\nprint('FeatureCollection from a single feature', singleFeatureFc);\n\n// FeatureCollection from a list of features.\nvar listOfFeatures = [\n ee.Feature(ee.Geometry.Point(-62.54, -27.32), {key: 'val1'}),\n ee.Feature(ee.Geometry.Point(-69.18, -10.64), {key: 'val2'}),\n ee.Feature(ee.Geometry.Point(-45.98, -18.09), {key: 'val3'})\n];\nvar listOfFeaturesFc = ee.FeatureCollection(listOfFeatures);\nprint('FeatureCollection from a list of features', listOfFeaturesFc);\n\n// FeatureCollection from GeoJSON.\nvar geojson = {\n \"type\": \"FeatureCollection\",\n \"columns\": {\n \"key\": \"String\",\n \"system:index\": \"String\"\n },\n \"features\": [\n {\n \"type\": \"Feature\",\n \"geometry\": {\n \"type\": \"Point\",\n \"coordinates\": [\n -62.54,\n -27.32\n ]\n },\n \"id\": \"0\",\n \"properties\": {\n \"key\": \"val1\"\n }\n }\n ]\n};\nvar geojsonFc = ee.FeatureCollection(geojson);\nprint('FeatureCollection from GeoJSON', geojsonFc);\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 from a string (collection name). Note that this only works\n# with client-side strings, it won't accept computed, server-side strings.\ncollection_name = 'WRI/GPPD/power_plants'\ncollection_name_fc = ee.FeatureCollection(collection_name)\nprint('FeatureCollection from a string:', collection_name_fc.limit(5).getInfo())\n\n# FeatureCollection from a single geometry.\nsingle_geometry = ee.Geometry.Point(-62.54, -27.32)\nsingle_geometry_fc = ee.FeatureCollection(single_geometry)\nprint('FeatureCollection from a single geometry:', single_geometry_fc.getInfo())\n\n# FeatureCollection from a single feature.\nsingle_feature = ee.Feature(ee.Geometry.Point(-62.54, -27.32), {'key': 'val'})\nsingle_feature_fc = ee.FeatureCollection(single_feature)\nprint('FeatureCollection from a single feature:', single_feature_fc.getInfo())\n\n# FeatureCollection from a list of features.\nlist_of_features = [\n ee.Feature(ee.Geometry.Point(-62.54, -27.32), {'key': 'val1'}),\n ee.Feature(ee.Geometry.Point(-69.18, -10.64), {'key': 'val2'}),\n ee.Feature(ee.Geometry.Point(-45.98, -18.09), {'key': 'val3'})\n]\nlist_of_features_fc = ee.FeatureCollection(list_of_features)\nprint('FeatureCollection from a list of features:',\n list_of_features_fc.getInfo())\n\n# FeatureCollection from GeoJSON.\ngeojson = {\n 'type': 'FeatureCollection',\n 'columns': {\n 'key': 'String',\n 'system:index': 'String'\n },\n 'features': [\n {\n 'type': 'Feature',\n 'geometry': {\n 'type': 'Point',\n 'coordinates': [\n -62.54,\n -27.32\n ]\n },\n 'id': '0',\n 'properties': {\n 'key': 'val1'\n }\n }\n ]\n }\ngeojson_fc = ee.FeatureCollection(geojson)\nprint('FeatureCollection from GeoJSON:', geojson_fc.getInfo())\n```"]]