Export.image.toDrive

画像をラスタとしてドライブにエクスポートするバッチタスクを作成します。タスクは [タスク] タブから開始できます。「crsTransform」、「scale」、「dimensions」は相互に排他的です。

用途戻り値
Export.image.toDrive(image, description, folder, fileNamePrefix, dimensions, region, scale, crs, crsTransform, maxPixels, shardSize, fileDimensions, skipEmptyTiles, fileFormat, formatOptions, priority)
引数タイプ詳細
image画像エクスポートする画像。
description文字列、省略可人が読める形式のタスク名。英字、数字、-、_ を使用できます（スペースは使用できません）。デフォルトは「myExportImageTask」です。
folder文字列、省略可エクスポートが保存される Google ドライブ フォルダ。注: （a）フォルダ名が任意のレベルに存在する場合、出力はそのフォルダに書き込まれます。（b）重複するフォルダ名が存在する場合、出力は最後に変更されたフォルダに書き込まれます。（c）フォルダ名が存在しない場合、ルートに新しいフォルダが作成されます。（d）区切り文字を含むフォルダ名（「path/to/file」など）は、システムパスではなくリテラル文字列として解釈されます。デフォルトはドライブのルートです。
fileNamePrefix文字列、省略可ファイル名の接頭辞。英字、数字、-、_ を使用できます（スペースは使用できません）。デフォルトは説明です。
dimensions数値|文字列、省略可エクスポートされた画像に使用するディメンション。最大ディメンションとして 1 つの正の整数、または「WIDTHxHEIGHT」を指定します。WIDTH と HEIGHT はそれぞれ正の整数です。
regionGeometry.LinearRing|Geometry.Polygon|String（省略可）エクスポートするリージョンを表す LinearRing、Polygon、または座標。これらは、Geometry オブジェクトまたは文字列としてシリアル化された座標として指定できます。
scale数値、省略可解像度（ピクセルあたりのメートル単位）。デフォルトは 1,000 です。
crs文字列、省略可エクスポートされたイメージに使用する CRS。
crsTransformList<Number>|String（省略可）エクスポートされた画像に使用するアフィン変換。「crs」を定義する必要があります。
maxPixels数値、省略可エクスポートするピクセル数を制限します。デフォルトでは、エクスポートが 1e8 ピクセルを超えるとエラーが表示されます。この値を明示的に設定すると、この上限を引き上げたり引き下げたりできます。
shardSize数値、省略可この画像が計算されるタイルのサイズ（ピクセル単位）。デフォルトは 256 です。
fileDimensionsList<Number>|Number（省略可）画像が大きすぎて 1 つのファイルに収まらない場合は、各画像ファイルのピクセル単位の寸法。正方形を示す単一の数値を指定するか、2 つのディメンションの配列を指定して（幅、高さ）を示すことができます。画像は、画像全体のサイズに合わせて切り抜かれます。shardSize の倍数にする必要があります。
skipEmptyTilesブール値、省略可true の場合、空（完全にマスクされた）画像タイルへの書き込みをスキップします。デフォルトは false です。GeoTIFF のエクスポートでのみサポートされます。
fileFormat文字列、省略可画像のエクスポート先の文字列ファイル形式。現在、GeoTIFF と TFRecord のみがサポートされています。デフォルトは GeoTIFF です。
formatOptionsImageExportFormatConfig（省略可）形式固有のオプションの文字列キーのディクショナリ。'GeoTIFF' の場合: 'cloudOptimized'（ブール値）、'noData'（浮動小数点数）。「TFRecord」の場合: https://developers.google.com/earth-engine/guides/tfrecord#formatoptions をご覧ください。
priority数値、省略可プロジェクト内のタスクの優先度。優先度の高いタスクは、より早くスケジュールされます。0 ～ 9999 の整数を指定してください。デフォルトは 100 です。

例

コードエディタ（JavaScript）

// A Landsat 8 surface reflectance image.
var image = ee.Image('LANDSAT/LC08/C02/T1_L2/LC08_044034_20210508')
  .select(['SR_B.']);  // reflectance bands

// A region of interest.
var region = ee.Geometry.BBox(-122.24, 37.13, -122.11, 37.20);

// Set the export "scale" and "crs" parameters.
Export.image.toDrive({
  image: image,
  description: 'image_export',
  folder: 'ee_demos',
  region: region,
  scale: 30,
  crs: 'EPSG:5070'
});

// Use the "crsTransform" export parameter instead of "scale" for more control
// over the output grid. Here, "crsTransform" is set to align the output grid
// with the grid of another dataset. To view an image's CRS transform:
// print(image.projection())
Export.image.toDrive({
  image: image,
  description: 'image_export_crstransform',
  folder: 'ee_demos',
  region: region,
  crsTransform: [30, 0, -2493045, 0, -30, 3310005],
  crs: 'EPSG:5070'
});

// If the export has more than 1e8 pixels, set "maxPixels" higher.
Export.image.toDrive({
  image: image,
  description: 'image_export_maxpixels',
  folder: 'ee_demos',
  region: region,
  scale: 30,
  crs: 'EPSG:5070',
  maxPixels: 1e13
});

// Export a Cloud Optimized GeoTIFF (COG) by setting the "cloudOptimized"
// parameter to true.
Export.image.toDrive({
  image: image,
  description: 'image_export_cog',
  folder: 'ee_demos',
  region: region,
  scale: 30,
  crs: 'EPSG:5070',
  formatOptions: {
    cloudOptimized: true
  }
});

// Define a nodata value and replace masked pixels with it using "unmask".
// Set the "sameFootprint" parameter as "false" to include pixels outside of the
// image geometry in the unmasking operation.
var noDataVal = -9999;
var unmaskedImage = image.unmask({value: noDataVal, sameFootprint: false});
// Use the "noData" key in the "formatOptions" parameter to set the nodata value
// (GeoTIFF format only).
Export.image.toDrive({
  image: unmaskedImage,
  description: 'image_export_nodata',
  folder: 'ee_demos',
  region: image.geometry(),  // full image bounds
  scale: 2000,  // large scale for minimal demo
  crs: 'EPSG:5070',
  fileFormat: 'GeoTIFF',
  formatOptions: {
    noData: noDataVal
  }
});

Python の設定

Python API とインタラクティブな開発での geemap の使用については、 Python 環境のページをご覧ください。

import ee
import geemap.core as geemap

Colab（Python）

# A Landsat 8 surface reflectance image.
image = ee.Image(
    'LANDSAT/LC08/C02/T1_L2/LC08_044034_20210508'
).select(['SR_B.'])  # reflectance bands

# A region of interest.
region = ee.Geometry.BBox(-122.24, 37.13, -122.11, 37.20)

# Set the export "scale" and "crs" parameters.
task = ee.batch.Export.image.toDrive(
    image=image,
    description='image_export',
    folder='ee_demos',
    region=region,
    scale=30,
    crs='EPSG:5070'
)
task.start()

# Use the "crsTransform" export parameter instead of "scale" for more control
# over the output grid. Here, "crsTransform" is set to align the output grid
# with the grid of another dataset. To view an image's CRS transform:
# print(image.projection().getInfo())
task = ee.batch.Export.image.toDrive(
    image=image,
    description='image_export_crstransform',
    folder='ee_demos',
    region=region,
    crsTransform=[30, 0, -2493045, 0, -30, 3310005],
    crs='EPSG:5070'
)
task.start()

# If the export has more than 1e8 pixels, set "maxPixels" higher.
task = ee.batch.Export.image.toDrive(
    image=image,
    description='image_export_maxpixels',
    folder='ee_demos',
    region=region,
    scale=30,
    crs='EPSG:5070',
    maxPixels=1e13
)
task.start()

# Export a Cloud Optimized GeoTIFF (COG) by setting the "cloudOptimized"
# parameter to true.
task = ee.batch.Export.image.toDrive(
    image=image,
    description='image_export_cog',
    folder='ee_demos',
    region=region,
    scale=30,
    crs='EPSG:5070',
    formatOptions={
        'cloudOptimized': True
    }
)
task.start()

# Define a nodata value and replace masked pixels with it using "unmask".
# Set the "sameFootprint" parameter as "false" to include pixels outside of the
# image geometry in the unmasking operation.
nodata_val = -9999
unmasked_image = image.unmask(value=nodata_val, sameFootprint=False)
# Use the "noData" key in the "formatOptions" parameter to set the nodata value
# (GeoTIFF format only).
task = ee.batch.Export.image.toDrive(
    image=unmasked_image,
    description='image_export_nodata',
    folder='ee_demos',
    region=image.geometry(),  # full image bounds
    scale=2000,  # large scale for minimal demo
    crs='EPSG:5070',
    fileFormat='GeoTIFF',
    formatOptions={
        'noData': nodata_val
    }
)
task.start()