お知らせ:
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]
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は 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```"]]
