AI-generated Key Takeaways
-
The
getInfo()function is an imperative function that uses an AJAX call to return all known information about a feature collection. -
It returns a
FeatureCollectionDescriptionwhich includes a list of feature metadata and an optional dictionary of collection properties. -
The function can be used synchronously or with an optional callback function.
-
Using
getInfo()transfers data from Earth Engine servers to the client, which can negatively affect performance and should be used with caution.
Returns a collection description whose fields include:
- features: a list containing metadata about the features in the collection.
- properties: an optional dictionary containing the collection's metadata properties.
| Usage | Returns |
|---|---|
FeatureCollection.
getInfo
( callback
)
|
FeatureCollectionDescription |
| Argument | Type | Details |
|---|---|---|
|
this:
featurecollection
|
FeatureCollection | The FeatureCollection instance. |
callback
|
Function, optional | An optional callback. If not supplied, the call is made synchronously. If supplied, will be called with the first parameter if successful and the second if unsuccessful. |
Examples
Code Editor (JavaScript)
/** * WARNING: this function transfers data from Earth Engine servers to the * client. Doing so can negatively affect request processing and client * performance. Server-side options should be used whenever possible. * Learn more about the distinction between server and client: * https://developers.google.com/earth-engine/guides/client_server */ // A server-side ee.FeatureCollection of power plants in Belgium. var fcServer = ee . FeatureCollection ( 'WRI/GPPD/power_plants' ) . filter ( 'country_lg == "Belgium"' ); // Use getInfo to transfer server-side feature collection to the client. The // result is an object. var fcClient = fcServer . getInfo (); print ( 'Client-side feature collection is an object' , typeof fcClient ); print ( 'Feature collection object keys' , Object . keys ( fcClient )); print ( 'Array of features' , fcClient . features ); print ( 'Properties of first feature' , fcClient . features [ 0 ]. properties );
import ee import geemap.core as geemap
Colab (Python)
"""WARNING: this function transfers data from Earth Engine servers to the client. Doing so can negatively affect request processing and client performance. Server-side options should be used whenever possible. Learn more about the distinction between server and client: https://developers.google.com/earth-engine/guides/client_server """ # A server-side ee.FeatureCollection of power plants in Belgium. fc_server = ee . FeatureCollection ( 'WRI/GPPD/power_plants' ) . filter ( 'country_lg == "Belgium"' ) # Use getInfo to transfer server-side feature collection to the client. The # result is an object. fc_client = fc_server . getInfo () display ( 'Client-side feature collection is a dictionary:' , type ( fc_client )) display ( 'Feature collection dictionary keys:' , fc_client . keys ()) display ( 'Array of features:' , fc_client [ 'features' ]) display ( 'Properties of first feature:' , fc_client [ 'features' ][ 0 ][ 'properties' ])
