公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Number.getInfo
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
從伺服器擷取這個物件的值。
如果未提供回呼函式，系統會同步提出要求。如果提供回呼，要求會以非同步方式提出。
非同步模式是首選，因為同步模式會在等待伺服器時停止所有其他程式碼 (例如 EE Code Editor UI)。如要提出非同步要求，請使用 evaluate() 而非 getInfo()。
傳回這個物件的計算值。
| 用量 | 傳回 |
|---|
Number.getInfo(callback) | 物件 |
| 引數 | 類型 | 詳細資料 |
|---|
this：computedobject | ComputedObject | ComputedObject 例項。 |
callback | 函式 (選用) | 選用的回呼。如未提供，系統會以同步方式進行呼叫。 |
範例
程式碼編輯器 (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.
var numberClient = numberServer.getInfo();
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 設定
請參閱「
Python 環境」頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
"""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.
number_server = ee.Number(10.3)
number_client = number_server.getInfo()
print('Client-side primitive data type:', type(number_client)) # float
print('Client-side number:', number_client) # 10.3
print('Client-side number used in expression:', number_client + 10) # 20.3
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eRetrieves the computed value of an object from the Earth Engine server, transferring it to the client.\u003c/p\u003e\n"],["\u003cp\u003eOffers synchronous and asynchronous modes, with the asynchronous mode (using \u003ccode\u003eevaluate()\u003c/code\u003e) being preferred for better performance.\u003c/p\u003e\n"],["\u003cp\u003eSynchronous requests using \u003ccode\u003egetInfo()\u003c/code\u003e can block other code execution while waiting for the server response.\u003c/p\u003e\n"],["\u003cp\u003eIt's important to be mindful of the potential performance impact of transferring server-side data to the client.\u003c/p\u003e\n"]]],[],null,["# ee.Number.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| Number.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/**\n * WARNING: this function transfers data from Earth Engine servers to the\n * client. Doing so can negatively affect request processing and client\n * performance. Server-side options should be used whenever possible.\n * Learn more about the distinction between server and client:\n * https://developers.google.com/earth-engine/guides/client_server\n */\n\n// A server-side ee.Number object.\nvar numberServer = ee.Number(10.3);\n\n// Use evaluate to transfer server-side number to the client.\nvar numberClient = numberServer.getInfo();\nprint('Client-side primitive data type', typeof numberClient); // number\nprint('Client-side number', numberClient); // 10.3\nprint('Client-side number used in expression', numberClient + 10); // 20.3\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\"\"\"WARNING: this function transfers data from Earth Engine servers to the\nclient. Doing so can negatively affect request processing and client\nperformance. Server-side options should be used whenever possible.\nLearn more about the distinction between server and client:\nhttps://developers.google.com/earth-engine/guides/client_server\n\"\"\"\n\n# A server-side ee.Number object.\nnumber_server = ee.Number(10.3)\n\nnumber_client = number_server.getInfo()\nprint('Client-side primitive data type:', type(number_client)) # float\nprint('Client-side number:', number_client) # 10.3\nprint('Client-side number used in expression:', number_client + 10) # 20.3\n```"]]
