Earth Engine 在 Google Cloud 上运行,需要使用云项目进行访问和 API 管理。所有 Earth Engine 调用(无论是来自代码编辑器、客户端库、应用还是 REST API)都会通过云项目进行路由,从而在 Cloud 控制台中实现访问权限控制、资源管理和用量监控。
获取 Earth Engine 访问权限
如需使用 Earth Engine,您需要有权访问满足以下条件的云项目:
创建项目
访问注册页面,创建并注册新的云项目或注册现有项目。注册后,Earth Engine 访问权限会立即启用。
您可以在 Google Cloud 控制台中管理注册过程中创建的项目。您可以在 Cloud 控制台上的 Earth Engine API 页面中启用或停用 Earth Engine API。
手动步骤(由注册页面自动执行)
创建 Cloud 项目
如果您还没有 Google Cloud 项目,请创建一个。您可以通过 Cloud 控制台的项目页面执行此操作,也可以点击以下按钮:
创建 Cloud 项目启用 Earth Engine API
如需为您的项目启用 Earth Engine API,请点击以下按钮前往 Earth Engine API 页面:
启用 Earth Engine API在 Earth Engine API 页面上,确保您已选择项目,然后点击启用按钮。
将项目注册为商业用途或非商业用途
修改项目的以下网址,访问该页面,然后完成注册流程。
https://code.earthengine.google.com/register?project=my-project
创建素材资源文件夹(可选)
您可以使用 earthengine create folder 命令,通过此处所述的路径,创建与您有权访问的 Cloud 项目关联的 Earth Engine 资产文件夹。例如:
earthengine create folder projects/my-project/assets/您还可以在代码编辑器中为项目创建资产文件夹,方法是在“资产”面板中添加项目。
除非您计划在项目中存储资产,否则无需创建此文件夹。
使用现有项目
请咨询贵组织的 IT 人员,了解是否已为 Earth Engine 配置了现有云项目。确保您用于访问 Earth Engine 服务的 Google 账号在项目中被授予了正确的角色和权限。
指定项目
以下部分介绍了如何为 Earth Engine 服务的各种接口指定项目。
客户端库(Python、JavaScript)
ee.Initialize() 函数用于为源自 Python 和 JavaScript 客户端库的 Earth Engine 请求指定项目。您可以通过多种方式配置项目规范,如需了解详情,请参阅身份验证和初始化页面。
代码编辑器
点击代码编辑器右上角的个人资料图标,然后从菜单中选择“更改云项目”。从选择对话框中选择一个项目。
Earth Engine 应用
发布 Earth Engine 应用时,系统会提示您选择一个项目来路由请求。按照发布对话框中的说明操作。
命令行工具
如需将命令行工具中的 Earth Engine 调用与云项目相关联,请在对 earthengine 的调用中使用 --project 参数,或使用 set_project 设置默认项目。
REST API
如需将对 REST API 的调用与云项目相关联,请发出经过身份验证的 HTTP 调用,其中身份验证由 oauth2 处理。在本地环境中,您可以使用 gcloud 命令。您还可以使用与云项目关联的服务账号。如需查看使用 google.oath.service_account.Credentials.from_service_account_file() 通过服务账号进行身份验证的示例,请参阅 REST API 快速入门。
配置项目访问权限
以下部分介绍了如何配置启用了 Earth Engine 的项目,以供其他个人和服务账号使用。
服务账号
服务账号的父级项目注册并启用 Earth Engine API 后,服务账号会自动获得访问权限。他们还需要在项目中拥有正确的权限。项目中的任意数量的服务账号都可以配置为使用 Earth Engine。访问服务账号页面,详细了解如何将服务账号与 Earth Engine 搭配使用。
Google 账号
云项目使用 Cloud IAM 来管理角色和权限。为了让其他用户通过您的项目访问 Earth Engine,您需要使用 Cloud 控制台向他们授予正确的角色和权限。
OAuth 2.0 客户端 ID
您可能需要从项目创建 OAuth 2.0 客户端 ID,例如,创建将用户凭据传递给 Earth Engine 的应用。您可以前往 Cloud 控制台菜单 (),然后选择 API 和服务 > 凭证,来管理云项目的凭证。(如果出现提示,请选择项目)。
如需为项目创建新的客户端 ID,请依次点击 + 创建凭证 > OAuth 客户端 ID > Web 应用。
在 Web 应用的配置中:
- 指定已获授权的 JavaScript 来源,例如:
http://localhost:8080
https://foo-ee-project.appspot.com
- 指定已获授权的重定向 URI,例如:
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback
常见使用场景
我正在教授一门教育课程…
太棒了!如果您注册非商业项目,则无需进行结算配置。然后,您可以将学生添加到项目中。
我属于运营团队/商业组织…
太棒了!您可以注册一个项目用于商业用途,并向其中添加协作者。另请注意您所选 Earth Engine 订阅中的席位限制。
Earth Engine 数据删除
账号级删除
账号级删除会从您的账号中移除所有 Earth Engine 数据。
如果您的账号属于 Google Workspace 组织,则您的管理员会控制您的账号数据。当管理员删除 Google 账号时,所有关联的 Earth Engine 数据都会在大约 30 天内被清除。
Earth Engine 团队无法恢复已删除的数据。
Cloud 项目
删除云项目会触发删除与该项目关联的 Earth Engine 数据(例如,存储在项目根目录中的任何资产、任何项目级 EE 应用、Monitoring 数据等)。此过程可能在 30 天内可逆,但 30 天后就无法恢复这些数据。
素材资源
删除资产的最简单方法是使用代码编辑器中的“资产”标签页查看并手动删除 Earth Engine 资产。
对于 ID 为 projects/{project-id}/assets/{asset-id} 的素材资源的程序化删除(例如 projects/my-project/assets/my-asset):
Python 客户端
ee.data.deleteAsset('projects/my-project/assets/my-asset')
JavaScript 客户端
请注意,代码编辑器的安全沙盒会阻止此调用在该环境中运行。
ee.data.deleteAsset('projects/my-project/assets/my-asset')
命令行工具
使用 rm 命令:
earthengine rm projects/my-project/assets/my-asset代码编辑器脚本
如需删除 Earth Engine 代码编辑器脚本,请执行以下操作:
代码编辑器
在代码编辑器的“脚本”标签页中,选择一个脚本或代码库,然后将其删除。代码库被标记为已删除后,将在 30 天内变为不可恢复。
使用 Git
高级用户可以使用 Git 来管理其脚本。请参阅 https://earthengine.googlesource.com/,列出您可以查看的代码库。
Earth Engine 应用
如需删除 Earth Engine 应用,请使用代码编辑器中的“应用”按钮来管理应用。
“获取链接”参考
使用“管理链接”页面,查看和删除您在代码编辑器中通过“获取链接”功能生成的链接。如需找到此页面,请前往“获取链接”按钮旁边的下拉菜单中的“管理链接”选项。
配置非商业用途访问权限
如需为您的项目设置非商业(免费)Earth Engine 访问权限,您需要在 Cloud 控制台中填写注册调查问卷,以确认您的项目是否符合资格条件。
验证
由于 Earth Engine 允许免费访问大量计算资源,因此 Google 要求对每个注册为非商业访问的项目进行验证。验证流程是注册的一部分。如果您完成验证调查问卷后,您的项目被认定为商业性质,则您将无法免费使用 Earth Engine。
自 2025 年 9 月 26 日起,所有非商业项目都必须在 Cloud 控制台中填写问卷。我们建议您尽快完成验证流程。如果您在 2025 年 9 月 26 日之前未采取行动,您的项目对 Earth Engine 的访问权限将被暂停,直到您完成验证流程。
重新验证
所有具有非商业用途访问权限的项目都需要定期重新验证访问权限。
配置商业访问权限
如需为项目设置商业(付费)Earth Engine 访问权限,您需要使用注册页面配置项目,并在结算账号中选择方案。
终止商业访问权限
如果您是 Earth Engine 的直接客户,并且希望停止在付费环境中使用 Earth Engine,则需要进行多项更改才能停止产生费用:
停止订阅扣款
- 如需终止结算账号的 Earth Engine 订阅,您需要使用“管理方案”页面(在使用与该结算账号关联的已注册云项目时,可从代码编辑器右上角的用户设置下拉菜单中访问该页面)。
您也可以直接访问结算账号的“管理方案”页面:
https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID选择“Limited”方案后,您的结算账号在当前结算周期结束后将不再产生任何 Earth Engine 平台订阅费用。
停止计算费用
停止存储费用
- 即使 API 已停用,存储的 Earth Engine 资产仍会产生费用。删除资产可避免产生更多 EE 存储费用。