ee.Number.evaluate
Asynchronously retrieves the value of this object from the server and passes it to the provided callback function.
| 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
/**
* 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
});
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
# The Earth Engine Python client library does not have an evaluate method for
# asynchronous evaluation of ee.Number objects.
# Use ee.Number.getInfo() instead.
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."],[[["`evaluate()` is a method of the `ComputedObject` 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-side `ee.Number` to the client in JavaScript."],["While JavaScript utilizes `evaluate()`, the Python client library recommends using `getInfo()` for similar asynchronous evaluation of `ee.Number` objects."]]],["The `evaluate` method asynchronously retrieves a `ComputedObject`'s value from the server and provides it to a callback function. The callback receives a success argument with the result or a failure argument with an error message. It's called on a `Number` object. The examples demonstrated transfering a server-side number to the client, using the retrieved value. Python does not have this method and recommends `getInfo()` instead.\n"]]