공지사항:
2025년 4월 15일 전에 Earth Engine 사용을 위해 등록된 모든 비상업용 프로젝트는 Earth Engine 액세스를 유지하기 위해
비상업용 자격 요건을 인증해야 합니다.
ee.Array.first
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
| 사용 | 반환 값 |
|---|
Array.first(right) | 배열 |
| 인수 | 유형 | 세부정보 |
|---|
다음과 같은 경우: left | 배열 | 왼쪽 값입니다. |
right | 배열 | 오른쪽 값입니다. |
예
코드 편집기 (JavaScript)
var empty = ee.Array([], ee.PixelType.int8());
print(empty.first(empty)); // []
print(ee.Array([0]).first(0)); // [0]
print(ee.Array([0, 1, 2]).first(1)); // [0,1,2]
print(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5]))); // [0,1,2]
print(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2]))); // [3,4,5]
Python 설정
Python API 및 geemap를 사용한 대화형 개발에 관한 자세한 내용은
Python 환경 페이지를 참고하세요.
import ee
import geemap.core as geemap
Colab (Python)
empty = ee.Array([], ee.PixelType.int8())
display(empty.first(empty)) # []
display(ee.Array([0]).first(0)) # [0]
display(ee.Array([0, 1, 2]).first(1)) # [0,1,2]
display(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5]))) # [0, 1, 2]
display(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2]))) # [3, 4, 5]
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 2025-07-26(UTC)"],[[["\u003cp\u003e\u003ccode\u003eArray.first()\u003c/code\u003e is an Earth Engine function that selects the values of the first array provided, regardless of the second array provided.\u003c/p\u003e\n"],["\u003cp\u003eThe function operates element-wise on the input array(s).\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eright\u003c/code\u003e argument, representing the second array, does not influence the output of the function.\u003c/p\u003e\n"],["\u003cp\u003eThe return value will always be the first array (\u003ccode\u003eleft\u003c/code\u003e).\u003c/p\u003e\n"]]],["The `first()` method selects values element-wise, prioritizing the left-hand array (`this: left`). If the left-hand array is empty, it returns an empty array. When used with a scalar value, it treats the value as an array of one element. The right-hand array, provided as an argument, is only used when there is no element in the left-hand array at a specific index. It returns an array object. The code snippets illustrate this in JavaScript and Python.\n"],null,["# ee.Array.first\n\nOn an element-wise basis, selects the value of the first value.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------|---------|\n| Array.first`(right)` | Array |\n\n| Argument | Type | Details |\n|--------------|-------|-----------------------|\n| this: `left` | Array | The left-hand value. |\n| `right` | Array | The right-hand value. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nvar empty = ee.Array([], ee.PixelType.int8());\nprint(empty.first(empty)); // []\n\nprint(ee.Array([0]).first(0)); // [0]\nprint(ee.Array([0, 1, 2]).first(1)); // [0,1,2]\nprint(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5]))); // [0,1,2]\nprint(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2]))); // [3,4,5]\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\nempty = ee.Array([], ee.PixelType.int8())\ndisplay(empty.first(empty)) # []\n\ndisplay(ee.Array([0]).first(0)) # [0]\ndisplay(ee.Array([0, 1, 2]).first(1)) # [0,1,2]\ndisplay(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5]))) # [0, 1, 2]\ndisplay(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2]))) # [3, 4, 5]\n```"]]
