Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.String.getInfo
Stay organized with collections
Save and categorize content based on your preferences.
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 | String.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
Code Editor (JavaScript)
// After getInfo(), the instance is a local JavaScript string.
// Regular JavaScript string manipulations are then available.
//
// Note: getInfo() fetches results from Earth Engine immediately, and may freeze
// the browser or lead to poor performance. Use evaluate() to avoid this.
print(ee.String('abc').getInfo().charAt(1)); // b
print(ee.String('abc').getInfo()[2]); // c
// Using + with ee.String has unexpected results
print(ee.String('abc') + 'def'); // ee.String("abc")def
// Fetch string using getInfo
print(ee.String('abc').getInfo() + 'def'); // abcdef
// Improved solution: cat is available on ee.String
print(ee.String('abc').cat('def')); // abcdef
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)
# After getInfo(), the instance is a local Python string.
# Regular Python string manipulations are then available.
# Note: getInfo() fetches results from Earth Engine synchronously;
# later expressions will not be evaluated until it completes.
print(ee.String('abc').getInfo()[-2]) # b
print(ee.String('abc').getInfo()[2]) # c
# Fetch string using getInfo
print(ee.String('abc').getInfo() + 'def') # abcdef
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."],[[["\u003cp\u003e\u003ccode\u003egetInfo()\u003c/code\u003e retrieves the value of a ComputedObject (like an \u003ccode\u003eee.String\u003c/code\u003e) from the Earth Engine server and returns it as a native object (like a JavaScript string or Python string).\u003c/p\u003e\n"],["\u003cp\u003eRequests can be synchronous (blocking) or asynchronous (non-blocking) depending on whether a callback function is provided.\u003c/p\u003e\n"],["\u003cp\u003eSynchronous requests (without a callback) can freeze the UI or cause poor performance; using \u003ccode\u003eevaluate()\u003c/code\u003e for asynchronous operations is generally preferred.\u003c/p\u003e\n"],["\u003cp\u003eAfter using \u003ccode\u003egetInfo()\u003c/code\u003e, you can apply regular string operations of the respective language (JavaScript/Python) on the returned object.\u003c/p\u003e\n"]]],[],null,["# ee.String.getInfo\n\n\u003cbr /\u003e\n\nRetrieves the value of this object from the server.\n\n\u003cbr /\u003e\n\nIf no callback function is provided, the request is made synchronously. If a callback is provided, the request is made asynchronously.\n\nThe 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().\n\nReturns the computed value of this object.\n\n| Usage | Returns |\n|--------------------------------|---------|\n| String.getInfo`(`*callback*`)` | Object |\n\n| Argument | Type | Details |\n|------------------------|--------------------|------------------------------------------------------------------------|\n| this: `computedobject` | ComputedObject | The ComputedObject instance. |\n| `callback` | Function, optional | An optional callback. If not supplied, the call is made synchronously. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// After getInfo(), the instance is a local JavaScript string.\n// Regular JavaScript string manipulations are then available.\n//\n// Note: getInfo() fetches results from Earth Engine immediately, and may freeze\n// the browser or lead to poor performance. Use evaluate() to avoid this.\n\nprint(ee.String('abc').getInfo().charAt(1)); // b\nprint(ee.String('abc').getInfo()[2]); // c\n\n// Using + with ee.String has unexpected results\nprint(ee.String('abc') + 'def'); // ee.String(\"abc\")def\n\n// Fetch string using getInfo\nprint(ee.String('abc').getInfo() + 'def'); // abcdef\n\n// Improved solution: cat is available on ee.String\nprint(ee.String('abc').cat('def')); // abcdef\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# After getInfo(), the instance is a local Python string.\n# Regular Python string manipulations are then available.\n\n# Note: getInfo() fetches results from Earth Engine synchronously;\n# later expressions will not be evaluated until it completes.\n\nprint(ee.String('abc').getInfo()[-2]) # b\nprint(ee.String('abc').getInfo()[2]) # c\n\n# Fetch string using getInfo\nprint(ee.String('abc').getInfo() + 'def') # abcdef\n```"]]