ee.Dictionary.getInfo
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.
| Usage | Returns |
|---|
Dictionary.getInfo(callback) | Object |
| Argument | Type | Details |
|---|
this: computedobject | ComputedObject | The ComputedObject instance. |
callback | Function, optional | An optional callback. If not supplied, the call is made synchronously. |
Examples
// A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).
var dict = ee.Dictionary({
B1: 182,
B2: 219,
B3: 443
});
// Request the server-side ee.Dictionary as a client-side object.
print('Client-side object', dict.getInfo());
print('Using the client-side object', Object.keys(dict.getInfo()).length);
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
# A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).
dic = ee.Dictionary({
'B1': 182,
'B2': 219,
'B3': 443
})
# Request the server-side ee.Dictionary as a client-side object.
print('Client-side object:', dic.getInfo())
print('Using the client-side object (e.g. fetch number of keys):',
len(dic.getInfo().keys()))
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["Retrieves the value of a ComputedObject from the Earth Engine server, enabling client-side use."],["Offers synchronous and asynchronous retrieval modes, with asynchronous being preferred to avoid blocking other code execution."],["`evaluate()` is recommended for asynchronous requests, while `getInfo()` can be used with a callback or synchronously."],["Returns the computed value as a client-side object, allowing interaction with it using standard JavaScript or Python methods."],["Provides JavaScript and Python code examples to illustrate how to retrieve and utilize the object's value."]]],["The `getInfo()` method retrieves an object's value from the server. It can operate synchronously, halting other code execution, or asynchronously via a callback function. Asynchronous mode is favored, and the `evaluate()` method is recommended in that case. The method returns the computed object value. Example usage involves requesting a server-side dictionary as a client-side object in both JavaScript and Python. This is illustrated with a dictionary of band values from an image, demonstrating both retrieval and simple usage of the object.\n"]]