Earth Engine 将推出非商业配额层级，以保护共享计算资源并确保为所有人提供可靠的性能。所有非商业项目都需要在 2026 年 4 月 27 日之前选择配额层级，否则系统会默认使用 Community 层级。层级配额将于 2026 年 4 月 27 日对所有项目生效（无论层级选择日期如何）。了解详情。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

管理资产

Earth Engine 资产是存储在平台内的项目自有地理空间数据。您可以上传自己的数据，并将通过 Earth Engine 分析生成的数据存储为资产。

资产类型

Earth Engine 为不同数据类型提供各种资产格式，并提供用于整理数据的容器元素。

资产类型
`Image`	一种基于网格的地理信息表示法，其中网格中的每个单元格都包含一个与地球表面上特定位置相对应的值。
`ImageCollection`	构成镶嵌或时间序列的相关光栅图像的集合。它在功能上类似于文件夹，但可以作为 `ee.ImageCollection` 对象导入到 Earth Engine 中，该对象包含一组用于过滤和分析的方法。
`Table`	一种由矢量要素（行）组成的表格数据结构，每个矢量要素都包含一系列属性（列）。它由 `ee.FeatureCollection` 对象表示，该对象包含一组用于过滤和分析的方法。
`Classifier`	经过训练的 Earth Engine 机器学习模型。它由 `ee.Classifier` 对象表示，该对象包含一组用于应用和分析的方法。
`FeatureView`	用于 Earth Engine 应用的表格的可视化视图。
`Folder`	用于存放素材资源和其他文件夹的容器，有助于整理素材资源。

资源组织

Earth Engine 资产整理为文件夹和集合的层次结构系统。该结构类似于常见的文件系统。

根

资产归 Cloud 项目所有。项目名称定义了资源目录的根。例如，my-project 的根为 projects/my-project/assets。属于 my-project 的所有素材资源都位于 projects/my-project/assets 文件夹或其中的子文件夹（或 ImageCollection）中。

Earth Engine 使用树状目录结构来整理资源。每个云项目都有一个根目录，其中可以包含单个资源和文件夹。ImageCollection 是一种特殊类型的资源，专门用于存放一组相关图片，例如时间序列或镶嵌图片。与文件夹不同，ImageCollection 只能包含图片素材资源，不能在其中嵌套其他文件夹或集合。

folder_dataprojects/my-project/assets/

文件夹 folder-name/

照片 image-name
view_comfy table-name
卫星 featureview-name
bubble_chart 分类器名称
photo_library imagecollection-name/

照片 image-name-1
照片 image-name-2

资产 ID

Earth Engine 使用资源 ID 在脚本和命令行操作中引用数据。它们使用正斜线 (/) 作为目录之间的分隔符来定义资源位置。例如，projects/my-project/assets/my-asset 指定了位于“my-project”根目录中名为“my-asset”的资源。以下示例展示了如何使用此 ID 获取有关资产的信息。

Python

print(ee.data.getAsset('projects/my-project/assets/my-asset'))

代码编辑器

print(ee.Image('projects/my-project/assets/my-asset'))

命令行

earthengine asset info projects/my-project/assets/my-asset

制作素材资源

您可以创建文件夹和 ImageCollection，并从本地文件或 Google Cloud Storage 存储分区中的文件提取图片和表格。支持的图片格式包括 GeoTIFF（标准和 COG）和 TFRecord。支持的表格格式包括 Shapefile 和 CSV。（也可以使用批处理函数 Export.*.toAsset 导出 Earth Engine 分析结果来创建资源）。

Python 客户端

图片

使用 ee.data.startIngestion 函数从 Cloud Storage 中提取图片。如需详细了解如何配置上传，请参阅映像清单页面。

manifest = {
  'name': 'projects/my-project/assets/asset-name',
  'tilesets': [
    {
      'sources': [
        {
          'uris': [
            'gs://my-bucket/filename.tif'
          ]
        }
      ]
    }
  ]
}
ee.data.startIngestion(None, manifest)

表

使用 ee.data.startTableIngestion 函数从 Cloud Storage 提取表。如需详细了解如何配置上传，请参阅映像清单页面。

manifest = {
  'name': 'projects/my-project/assets/asset-name',
  'sources': [
    {
      'uris': [
        'gs://my-bucket/filename.csv'
      ]
    }
  ]
}
ee.data.startTableIngestion(None, manifest)

文件夹或 ImageCollection

使用 ee.data.createAsset 函数创建空文件夹或 ImageCollection。

ee.data.createAsset(
    {'type': 'FOLDER'}, # or 'IMAGE_COLLECTION'
    'projects/my-project/assets/asset-name'
)

代码编辑器

在素材资源管理器中，点击新建按钮，然后从下拉列表中选择要上传或创建的素材资源类型。在对话框中配置素材资源上传或创建。

命令行

图片或表格

earthengine upload image --asset_id=projects/my-project/assets/asset-name gs://my-bucket/filename.tif
earthengine upload table --asset_id=projects/my-project/assets/asset-name gs://my-bucket/filename.csv

文件夹或 ImageCollection

使用 earthengine create 命令创建空文件夹或 ImageCollection。

earthengine create folder projects/my-project/assets/folder-name
earthengine create collection projects/my-project/assets/collection-name

外来图片

您上传到 Google Cloud Storage 存储分区的云优化 GeoTIFF (COG) 文件可以注册为外部映像资源，并直接在 Earth Engine 中使用。如需详细了解 COG 支持的资源以及如何构建清单，请参阅参考文档。

earthengine alpha upload external_image --manifest /tmp/foo.json

列出资产

Python 客户端

使用 ee.data.listAssets 函数列出文件夹或集合中的资产（非递归）。如需详细了解过滤和分页，请参阅参考文档。

ee.data.listAssets('projects/my-project/assets')

另请参阅 ee.data.listImages 和 ee.data.listFeatures。

代码编辑器

展开资源管理器中的文件夹以查看资源。

命令行

使用 earthengine ls 命令可列出文件夹或集合中的素材资源（非递归）。如需详细了解如何限制要列出的资源数量和要返回的详细信息量，请参阅参考文档。

earthengine ls projects/my-project/assets

设置资产权限

Python 客户端

使用 ee.data.setAssetAcl 函数设置资源的权限。

asset_id = 'projects/my-project/assets/asset-name'
acl_update = {
    'owners': [
        'user:big_cheese@example.com',
        'user:el_jefe@example.com'
    ],
    'writers': [
        'user:romeo@example.com',
        'user:juliet@example.com'
    ],
    'readers': [
        'group:some-group@googlegroups.com',
        'domain:example.com',
        'serviceAccount:some-project-id@appspot.gserviceaccount.com'
    ],
    'all_users_can_read': False
}
ee.data.setAssetAcl(asset_id, acl_update)

代码编辑器

在资产管理器中，将指针悬停在某个资产上，然后点击分享图标。在对话框中，输入要与之分享资产的电子邮件地址或网域，然后从下拉列表中选择要授予的权限级别。点击添加访问权限按钮以确认更改。选中“任何人都可以读取”复选框，以向任何实体授予读取权限。您还可以通过从下拉列表（活跃 Code Editor 项目所拥有的资源）中选择应用名称，在对话框中授予对 Earth Engine 应用的访问权限。

命令行

使用 earthengine acl set 命令将资源的读取权限设置为 public 或 private。

earthengine acl set public projects/my-project/assets/asset-name

使用 earthengine acl ch 命令设置资产读取和写入的各项权限。

earthengine acl ch -u person@gmail.com:R projects/my-project/assets/asset-name

如需了解更多详情，请参阅命令行参考页面。

检查资产权限

Python 客户端

使用 ee.data.getAssetAcl 函数获取资源的访问控制列表。

ee.data.getAssetAcl('projects/my-project/assets/asset-name')

代码编辑器

在资产管理器中，将指针悬停在某个资产上，然后点击分享图标。此对话框会显示电子邮件地址和网域的列表，以及它们各自的访问权限级别。

命令行

使用 earthengine acl get 命令可获取资产的访问控制列表。

earthengine acl get projects/my-project/assets/asset-name

复制素材资源

Python 客户端

使用 ee.data.copyAsset 函数复制资源。

ee.data.copyAsset('projects/my-project/assets/asset-name', 'projects/my-project/assets/asset-copy-name')

代码编辑器

使用 Python 客户端或命令行工具复制资源。

命令行

使用 earthengine cp 命令复制资源。

earthengine cp projects/my-project/assets/asset-name projects/my-project/assets/asset-copy-name

移动或重命名素材资源

Python 客户端

使用 ee.data.renameAsset 函数移动或重命名资源。

ee.data.renameAsset('projects/my-project/assets/asset-name', 'projects/my-project/assets/new-asset-name')

代码编辑器

Move

在资源管理器中，将资源拖到新文件夹中。

重命名

在素材资源管理器中，将指针悬停在某个素材资源上，然后点击修改图标，并在可修改的输入字段中输入新名称。

命令行

使用 earthengine mv 命令可移动或重命名资源。

earthengine mv projects/my-project/assets/asset-name projects/my-project/assets/new-asset-name

删除资产

Python 客户端

使用 ee.data.deleteAsset 函数删除资源。

ee.data.deleteAsset('projects/my-project/assets/asset-name')

代码编辑器

点击相应素材资源以打开素材资源对话框页面，然后点击删除按钮。

命令行

使用 earthengine rm 命令删除资源。如需了解递归和模拟运行选项，请参阅函数参考文档。

earthengine rm projects/my-project/assets/asset-name

查看资产元数据

Python 客户端

使用 ee.data.getAsset 函数可获取资源元数据。

ee.data.getAsset('projects/my-project/assets/asset-name')

代码编辑器

点击素材资源，打开素材资源对话框页面。查看资产信息。

命令行

使用 earthengine asset info 命令获取资源元数据。

earthengine asset info projects/my-project/assets/asset-name

设置资产元数据

您可以设置以下素材资源元数据：

start_time
end_time
properties

Python 客户端

使用 ee.data.updateAsset 函数更新资产元数据。

asset_id = 'projects/my-project/assets/asset-name'
new_metadata = {
  'properties': {
    'name': 'value'
  },
  'start_time': '2024-10-02T15:01:24Z',
  'end_time': '2024-10-02T15:01:25Z',
}
update_these = ['start_time', 'end_time', 'properties']

ee.data.updateAsset(asset_id, new_metadata, update_these)

代码编辑器

点击某个素材资源以打开素材资源对话框页面，然后激活右上角的修改切换开关。您可以修改说明、属性以及开始日期和结束日期。停用修改切换开关以保存更改。

命令行

使用 earthengine asset set 命令更新资源元数据。如需了解详情，请参阅参考文档。

earthengine asset set \
  --time_start 2024-10-02T15:01:24 \
  --time_end 2024-10-02T15:01:25 \
  --property 'name=value' \
  projects/my-project/assets/asset-name

检查素材资源配额

配额在项目级应用。如需详细了解资源配额，请参阅用量和配额限制页面。

Python 客户端

使用 ee.data.getAssetRootQuota 函数获取资源根目录的存储空间配额用量。

ee.data.getAssetRootQuota('projects/my-project/assets')

代码编辑器

在资源管理器中，将指针悬停在项目根目录上，然后点击 data_usage 图标。系统会显示一个信息对话框。

命令行

使用 Python 客户端或代码编辑器检查资源配额。

管理资产 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

资产类型

资源组织

根

目录

资产 ID

Python

代码编辑器

命令行

制作素材资源

Python 客户端

图片

表

文件夹或 ImageCollection

代码编辑器

命令行

图片或表格

文件夹或 ImageCollection

外来图片

列出资产

Python 客户端

代码编辑器

命令行

设置资产权限

Python 客户端

代码编辑器

命令行

检查资产权限

Python 客户端

代码编辑器

命令行

复制素材资源

Python 客户端

代码编辑器

命令行

移动或重命名素材资源

Python 客户端

代码编辑器

Move

重命名

命令行

删除资产

Python 客户端

代码编辑器

命令行

查看资产元数据

Python 客户端

代码编辑器

命令行

设置资产元数据

Python 客户端

代码编辑器

命令行

检查素材资源配额

Python 客户端

代码编辑器

命令行

管理资产