공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
ee.Number.getInfo
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
서버에서 이 객체의 값을 가져옵니다.
콜백 함수가 제공되지 않으면 요청이 동기식으로 이루어집니다. 콜백이 제공되면 요청이 비동기식으로 이루어집니다.
동기 모드는 서버를 기다리는 동안 다른 모든 코드 (예: EE 코드 편집기 UI)를 중지하므로 비동기 모드를 사용하는 것이 좋습니다. 비동기식 요청을 실행하려면 getInfo()보다 evaluate()를 사용하는 것이 좋습니다.
이 객체의 계산된 값을 반환합니다.
| 사용 | 반환 값 |
|---|
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 API 및 대화형 개발을 위한 geemap 사용에 관한 자세한 내용은
Python 환경 페이지를 참고하세요.
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
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\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```"]]
