お知らせ:
2025 年 4 月 15 日より前に Earth Engine の使用を登録したすべての非商用プロジェクトは、Earth Engine へのアクセスを維持するために
非商用目的での利用資格を確認する必要があります。
ee.ImageCollection.loadZarrV2Array
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
3 つ以上のディメンション(1 つ以上の非空間ディメンション)を、指定された非空間軸に沿ってスライスして ImageCollection として保存します。配列属性(.zattrs)には、各ディメンションの名前のリストである _ARRAY_DIMENSIONS フィールドを含める必要があります(例: ['time', 'y', 'x']). 少なくとも 2 つのディメンションが必要です。最後の 2 つはそれぞれ Y と X を表します(['lat', 'lon']). サポートされている圧縮コーデックは、blosc、gzip、lz4、zlib、zstd です。サポートされている blosc メタ圧縮コーデックは、「lz4」、「lz4hc」、「zlib」、「zstd」です(「blosclz」はサポートされていません)。
用途 | 戻り値 |
---|
ee.ImageCollection.loadZarrV2Array(uri, proj, axis, starts, ends) | ImageCollection |
引数 | タイプ | 詳細 |
---|
uri | 文字列 | 読み込む .zarray ファイルの Cloud Storage URI。アレイのディレクトリの親ディレクトリに .zmetadata ファイルが存在している必要があります(例: 「gs://b/o/.zarray」の場合、「gs://b/.zmetadata」が存在している必要があります)。バケットのメタデータにアクセスできる必要があります(「storage.buckets.get」権限が必要です。この権限は、ロール「Storage Legacy Bucket Reader」によって提供されます。https://cloud.google.com/storage/docs/access-control/iam-roles をご覧ください)。また、バケットは米国のマルチリージョン、US-CENTRAL1 を含むデュアルリージョン、または US-CENTRAL1 リージョンに配置する必要があります。 |
proj | 予測 | 配列の射影。 |
axis | Integer, default: null | アレイをスライスして ImageCollection を作成する非空間軸(0 番目からインデックス付け)。コレクション内の各画像は、この軸に沿った単一のスライス(長さ 1)を表します。null の場合、デフォルトは 0 です。値は [0, N-1] の範囲内である必要があります。ここで、N は空間以外のディメンションの数(つまり、合計ディメンション数 - 2)です。配列には、空間以外のディメンションが少なくとも 1 つ必要です(つまり、3 次元以上である必要があります)。 |
starts | リスト、デフォルト: null | 各空間以外のディメンションに沿ってスライスの取得を開始するインデックス(両端を含む)。null の場合、空間以外のすべてのディメンションでスライスはインデックス 0 から開始されます。指定する場合、このリストの長さは空間以外のディメンションの数(合計ディメンション数 - 2)と同じにする必要があります。リスト内の個々の要素は null にすることができます。この場合、そのディメンションのデフォルトは 0 になります。負の番号はディメンションの末尾からカウントされます(例: -1 は最後の要素です)。 |
ends | リスト、デフォルト: null | 各空間以外のディメンションに沿ってスライスの取得を停止するインデックス(番号は含まない)。null の場合、スライスは対応する各非空間ディメンションの末端まで延びます(デフォルトはディメンションの長さ)。指定する場合、このリストの長さは空間以外のディメンションの数(合計ディメンション数 - 2)と同じにする必要があります。リスト内の個々の要素は null にできます。この場合、デフォルトでそのディメンションの長さになります。負の番号はディメンションの末尾からカウントされます(例: -1 は最後の要素です)。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],null,["# ee.ImageCollection.loadZarrV2Array\n\nLoads a Zarr v2 array with 3 or more dimensions (i.e., 1 or more non-spatial dimensions) as an ImageCollection by slicing along a specified non-spatial axis. The array attributes (.zattrs) must contain the field '_ARRAY_DIMENSIONS', which is a list of the names of each dimension (e.g., \\['time', 'y', 'x'\\]). There must be at least two dimensions, with the final two representing Y and X respectively (e.g., \\['lat', 'lon'\\]). The supported compression codecs are 'blosc', 'gzip', 'lz4', 'zlib', and 'zstd'. The supported blosc meta-compression codecs are 'lz4', lz4hc', 'zlib', and 'zstd' ('blosclz' is not supported).\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------------------------------------------|-----------------|\n| `ee.ImageCollection.loadZarrV2Array(uri, proj, `*axis* `, `*starts* `, `*ends*`)` | ImageCollection |\n\n| Argument | Type | Details |\n|----------|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `uri` | String | The Cloud Storage URI of the .zarray file to load. A .zmetadata file must be present in the parent directory of the array's directory (e.g., for 'gs://b/o/.zarray', 'gs://b/.zmetadata' must be present). The bucket metadata must be accessible (requires the \\`storage.buckets.get\\` permission which is provided by the role \"Storage Legacy Bucket Reader\" among others, see https://cloud.google.com/storage/docs/access-control/iam-roles) and the bucket must be located in the US multi-region, a dual-region including US-CENTRAL1, or the US-CENTRAL1 region. |\n| `proj` | Projection | The projection of the array. |\n| `axis` | Integer, default: null | The non-spatial axis (0-indexed) along which to slice the array to create an ImageCollection. Each image in the collection represents a single slice (length 1) along this axis. If null, defaults to 0. The value must be in the range \\[0, N-1\\], where N is the number of non-spatial dimensions (i.e., total dimensions - 2). The array must have at least one non-spatial dimension (i.e., be at least 3 dimensional). |\n| `starts` | List, default: null | The indices (inclusive) at which to start taking slices along each non-spatial dimension. If null, slices will start at index 0 for all non-spatial dimensions. If specified, this list must have a length equal to the number of non-spatial dimensions (total dimensions - 2). An individual element within the list may be null, which defaults to 0 for that dimension. Negative indices are counted from the end of the dimension (e.g., -1 is the last element). |\n| `ends` | List, default: null | The indices (exclusive) at which to stop taking slices along each non-spatial dimension. If null, slices will extend to the end of each corresponding non-spatial dimension (i.e., defaults to the length of the dimension). If specified, this list must have a length equal to the number of non-spatial dimensions (total dimensions - 2). An individual element within the list may be null, which also defaults to the length of that dimension. Negative indices are counted from the end of the dimension (e.g., -1 is the last element). |"]]