ee.FeatureCollection
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
FeatureCollection ها را می توان از آرگومان های زیر ساخت:
- یک رشته: نام یک مجموعه فرض می شود.
- یک هندسه واحد.
- یک ویژگی واحد
- لیستی از ویژگی ها
- مجموعه ویژگی های GeoJSON
- یک شی محاسبه شده: به عنوان یک مجموعه دوباره تفسیر می شود.
استفاده | برمی گرداند | ee.FeatureCollection(args, column ) | مجموعه ویژگی ها |
استدلال | تایپ کنید | جزئیات | args | ComputedObject|Feature|FeatureCollection|هندسه|List<Object>|Number|String | آرگومان های سازنده |
column | رشته، اختیاری | نام ستون هندسه مورد استفاده. فقط هنگام کار با یک مجموعه نامگذاری شده مفید است. |
نمونه ها
ویرایشگر کد (جاوا اسکریپت)
// 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);
راه اندازی پایتون
برای اطلاعات در مورد API پایتون و استفاده از geemap
برای توسعه تعاملی به صفحه محیط پایتون مراجعه کنید.
import ee
import geemap.core as geemap
کولب (پایتون)
# 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())
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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```"]]