ee.Geometry.getInfo

  • getInfo() retrieves the value of a ComputedObject (like Geometry) from the Earth Engine server.

  • Requests can be synchronous (blocking) or asynchronous (non-blocking) depending on the presence of a callback function.

  • Asynchronous requests, preferably using evaluate(), are recommended to avoid UI freezes.

  • The function returns the computed value of the object as an object.

  • getInfo() is demonstrated with examples in both JavaScript and Python within the Google Earth Engine environment.

Retrieves the value of this object from the server.

If no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.

The asynchronous mode is preferred because the synchronous mode stops all other code (for example, the EE Code Editor UI) while waiting for the server. To make an asynchronous request, evaluate() is preferred over getInfo().

Returns the computed value of this object.

UsageReturns
Geometry.getInfo(callback)Object
ArgumentTypeDetails
this: computedobjectComputedObjectThe ComputedObject instance.
callbackFunction, optionalAn optional callback. If not supplied, the call is made synchronously.

Examples

Code Editor (JavaScript)

// Define a Geometry object.
var geometry = ee.Geometry({
  'type': 'Polygon',
  'coordinates':
    [[[-122.081, 37.417],
      [-122.086, 37.421],
      [-122.084, 37.418],
      [-122.089, 37.416]]]
});

// Apply the getInfo method to the Geometry object.
var geometryGetInfo = geometry.getInfo();

// Print the result to the console.
print('geometry.getInfo(...) =', geometryGetInfo);

// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(geometry,
             {'color': 'black'},
             'Geometry [black]: geometry');

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

import ee
import geemap.core as geemap

Colab (Python)

# Define a Geometry object.
geometry = ee.Geometry({
    'type': 'Polygon',
    'coordinates': [[
        [-122.081, 37.417],
        [-122.086, 37.421],
        [-122.084, 37.418],
        [-122.089, 37.416],
    ]],
})

# Apply the getInfo method to the Geometry object.
geometry_get_info = geometry.getInfo()

# Print the result.
display('geometry.getInfo(...) =', geometry_get_info)

# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(geometry, {'color': 'black'}, 'Geometry [black]: geometry')
m