Cloud Assets

Earth Engine 资源(例如图片、表格)可以是旧版资源(即未与 Cloud 项目关联),也可以是与 Google Cloud 项目关联的资源。本指南介绍了如何使用资产管理器上传和/或使用与 Cloud 项目关联的资产。

Cloud Asset Manager

Cloud Asset Manager 包含云端资产部分、旧版资产部分和添加项目按钮。

Cloud Asset Manager
图 1. Earth Engine 代码编辑器的 Cloud Asset Manager。

云资产

“云资产”部分包含属于固定到资产管理器的任何云项目的资产。默认情况下,此处会显示为代码编辑器会话选择的 Cloud 项目(如代码编辑器右上角所示)。如需固定其他项目,请选择添加项目按钮,然后在选择 Cloud 项目对话框中选择一个项目。这些项目中的资源将显示在最初展开的 zippy 中,嵌套文件夹最初处于收起状态。

旧版素材资源

旧版资产是指在 Earth Engine 与 Cloud 集成之前与您的 Earth Engine 账号相关联的资产。

添加项目

点击添加项目按钮将打开选择云项目对话框。

“选择项目”对话框
图 2. 选择“选择 Cloud 项目”对话框。

此对话框将显示一个下拉菜单,用于选择 Cloud 项目,并显示该项目中存在的 Earth Engine 资产。 您之前固定的项目会显示为 Earth Engine 已启用项目。在下拉菜单中选择一个 Cloud 项目,然后点击选择,即可将该项目固定到“Cloud 资产”部分,并显示该项目中包含的资产。

如果选择已固定的项目,系统会提供取消固定该项目的选项。

上传资源

使用上传素材资源按钮上传素材资源。默认情况下,上传的素材资源将与代码编辑器中选择的项目相关联。如果您希望将新资源与另一个项目相关联,请通过上传对话框提供的项目选择器选择另一个项目。

管理素材资源

您可以通过代码编辑器的资源管理器标签页、命令行、客户端库(例如 ee.data.getAsset)或直接通过 REST API 管理资源。

管理资产权限

如需向其他用户授予对您的资产的读取、写入或完全管理控制权限,您可以为资产和/或项目设置权限。如需了解详情,请参阅“访问权限控制”页面

访问素材资源

资源路径的格式为 projects/${PROJECT_NAME}/assets/${ASSET_NAME}。 这些路径用于客户端库构造函数中、通过某个客户端库进行导出时、在提取或上传时以及在 REST API 调用中。

公开资源

公共目录中的图片可通过 projects/earthengine-public/assets/path/to/asset/asset-id 等路径进行访问。例如,以下是一个 Landsat 场景:

projects/earthengine-public/assets/LANDSAT/LC08/C02/T1_RT/LC08_001004_20140609

请注意,此示例中的 PROJECT_NAMEearthengine-public。 这些路径可以直接传递给构造函数,例如 ImageImageCollectionFeatureCollection。您还可以将资源路径传递给 REST API。 以下是 REST 快速入门中的一个非常简单的示例。

个人资产

如需访问您拥有或有权查看的项目中存储的 Earth Engine 资产,请将 PROJECT_NAME 设置为拥有该资产的项目的 ID。例如:

projects/my-ee-enabled-project-id/assets/my-asset-id

在此示例中,my-ee-enabled-project-id 是之前已通过其上传或创建过媒体资源的项目名称。如需详细了解如何在 Cloud 项目中启用 Earth Engine API,请参阅项目页面。

旧版素材资源

旧版资源是指存储在旧版 users/projects/ 文件夹中的资源。访问这些资源时,PROJECT_NAMEearthengine-legacy。例如:

projects/earthengine-legacy/assets/users/user-name/my-asset-id

访问 Cloud Storage 中的图片

您可以使用 ee.Image.loadGeoTIFF() 直接从 Cloud Storage 存储分区访问 Cloud Optimized GeoTIFF (COG)。 您还可以创建 COG 支持的 Earth Engine 资源,如此 REST API 示例中所述。