AI-generated Key Takeaways
-
evaluate()
is a method of theComputedObject
class and allows retrieving the value of the object from the Earth Engine server asynchronously. -
It takes a callback function that handles the evaluated result or any potential errors encountered during evaluation.
-
The provided example demonstrates how to use
evaluate()
to transfer a server-sideee.Number
to the client in JavaScript. -
While JavaScript utilizes
evaluate()
, the Python client library recommends usinggetInfo()
for similar asynchronous evaluation ofee.Number
objects.
Usage | Returns |
---|---|
Number.evaluate(callback) |
Argument | Type | Details |
---|---|---|
this: computedobject | ComputedObject | The ComputedObject instance. |
callback | Function | A function of the form function(success, failure), called when the server returns an answer. If the request succeeded, the success argument contains the evaluated result. If the request failed, the failure argument will contains an error message. |
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.Number object. var numberServer = ee.Number(10.3); // Use evaluate to transfer server-side number to the client. numberServer.evaluate(function(numberClient) { print('Client-side primitive data type', typeof numberClient); // number print('Client-side number', numberClient); // 10.3 print('Client-side number used in expression', numberClient + 10); // 20.3 });
import ee import geemap.core as geemap
Colab (Python)
# The Earth Engine Python client library does not have an evaluate method for # asynchronous evaluation of ee.Number objects. # Use ee.Number.getInfo() instead.