Page Summary
-
FeatureCollections can be constructed from various arguments including a string, a single geometry or feature, a list of features, a GeoJSON FeatureCollection, or a computed object.
-
The
ee.FeatureCollection()constructor takesargsand an optionalcolumnargument and returns a FeatureCollection. -
The
argsargument accepts different types such as ComputedObject, Feature, FeatureCollection, Geometry, List of Objects, Number, or String. -
The optional
columnargument, a String, specifies the name of the geometry column to use, relevant only for named collections. -
Examples demonstrate constructing FeatureCollections from a string name, a single geometry, a single feature, a list of features, and GeoJSON data using both JavaScript and Python.
- A string: assumed to be the name of a collection.
- A single geometry.
- A single feature.
- A list of features.
- A GeoJSON FeatureCollection
- A computed object: reinterpreted as a collection.
| Usage | Returns |
|---|---|
ee.FeatureCollection(args, column
)
|
FeatureCollection |
| Argument | Type | Details |
|---|---|---|
args
|
ComputedObject|Feature|FeatureCollection|Geometry|List<Object>|Number|String | The constructor arguments. |
column
|
String, optional | The name of the geometry column to use. Only useful when working with a named collection. |
Examples
Code Editor (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 );
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 ) display ( 'FeatureCollection from a string:' , collection_name_fc . limit ( 5 )) # FeatureCollection from a single geometry. single_geometry = ee . Geometry . Point ( - 62.54 , - 27.32 ) single_geometry_fc = ee . FeatureCollection ( single_geometry ) display ( 'FeatureCollection from a single geometry:' , single_geometry_fc ) # 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 ) display ( 'FeatureCollection from a single feature:' , single_feature_fc ) # 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 ) display ( 'FeatureCollection from a list of features:' , list_of_features_fc ) # 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 ) display ( 'FeatureCollection from GeoJSON:' , geojson_fc )
