إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.FeatureCollection
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن إنشاء FeatureCollections من الوسيطات التالية:
- سلسلة: يُفترض أنّها اسم مجموعة.
- شكل هندسي واحد
- ميزة واحدة
- قائمة بالميزات
- مجموعة 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 للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام
geemap
للتطوير التفاعلي.
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())
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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```"]]