Доступ к земному двигателю

Earth Engine работает на платформе Google Cloud и требует наличия облачных проектов для управления доступом и API. Все вызовы Earth Engine (будь то из редактора кода, клиентских библиотек, приложений или REST API) направляются через облачный проект, что обеспечивает контроль доступа, управление ресурсами и мониторинг использования в облачной консоли.

Получите доступ к Earth Engine

Для использования Earth Engine вам потребуется доступ к облачному проекту, который:

Создать проект

Перейдите на страницу регистрации , чтобы создать и зарегистрировать новый облачный проект или зарегистрировать существующий. После регистрации доступ к Earth Engine будет предоставлен немедленно.

Проекты, созданные в процессе регистрации, можно управлять в консоли Google Cloud . Вы можете активировать или деактивировать API Earth Engine на странице API Earth Engine в консоли Cloud .

Шаги, выполняемые вручную (автоматизированные на странице регистрации)

Создать облачный проект

Если вы еще этого не сделали, создайте проект Google Cloud . Сделать это можно на странице проектов в консоли Cloud или нажав следующую кнопку:

Create a Cloud project

Включите API Earth Engine.

Чтобы включить API Earth Engine для вашего проекта, нажмите следующую кнопку, чтобы перейти на страницу API Earth Engine:

Включите API Earth Engine.

На странице API Earth Engine убедитесь, что вы выбрали свой проект, и нажмите кнопку «Включить» .

Зарегистрируйте проект для коммерческого или некоммерческого использования.

Отредактируйте URL-адрес вашего проекта, перейдите на страницу и завершите процедуру регистрации.

https://code.earthengine.google.com/register?project=my-project

Создайте папку ресурсов (необязательно).

Вы можете создать папку ресурсов Earth Engine, связанную с облачным проектом, к которому у вас есть доступ, используя команду ` earthengine create folder указав путь, как описано здесь . Например:

earthengine create folder projects/my-project/assets/

Также вы можете создать папку с ресурсами для проекта в редакторе кода, добавив проект на панели «Ресурсы».

Создавать эту папку не нужно, если вы не планируете хранить ресурсы в проекте.

Используйте существующий проект

Уточните у ИТ-специалистов вашей организации информацию о существующих облачных проектах, настроенных для Earth Engine. Убедитесь, что учетной записи Google, которую вы будете использовать для доступа к сервисам Earth Engine, предоставлены необходимые роли и разрешения для проекта.

Укажите проект

В следующих разделах описывается, как задать проект для различных интерфейсов к сервисам Earth Engine.

Клиентские библиотеки (Python, JavaScript)

Функция ee.Initialize() используется для указания проекта для запросов Earth Engine, поступающих из клиентских библиотек Python и JavaScript . Существует несколько способов настройки указания проекта; подробнее см. страницу аутентификации и инициализации .

Редактор кода

Щелкните значок профиля в правом верхнем углу редактора кода и выберите в меню пункт «Изменить облачный проект». Выберите проект в диалоговом окне выбора.

Приложения Earth Engine

При публикации приложения Earth Engine вам будет предложено выбрать проект, через который будут направляться запросы. Следуйте инструкциям в диалоговом окне публикации.

Инструмент командной строки

Чтобы связать вызовы Earth Engine из инструмента командной строки с проектом Cloud, используйте параметр --project в вызове earthengine или используйте set_project для установки проекта по умолчанию.

REST API

Чтобы связать вызовы REST API с проектом Cloud, выполняйте аутентифицированные HTTP-запросы, где аутентификация обрабатывается oauth2 . В локальной среде можно использовать команду gcloud . Также можно использовать учетную запись службы, связанную с проектом Cloud. Пример использования google.oath.service_account.Credentials.from_service_account_file() для аутентификации с помощью учетной записи службы см. в руководстве по быстрому запуску REST API.

Настройка доступа к проекту

В следующих разделах описывается, как настроить проекты с поддержкой Earth Engine для использования другими пользователями и учетными записями служб.

Служебные счета

Сервисные учетные записи автоматически получают доступ после регистрации родительского проекта и включения API Earth Engine. Им также необходимы соответствующие разрешения внутри проекта. Для использования Earth Engine можно настроить любое количество сервисных учетных записей в проекте. Для получения дополнительной информации об использовании сервисных учетных записей с Earth Engine посетите страницу сервисных учетных записей .

Аккаунты Google

В облачных проектах для управления ролями и разрешениями используется Cloud IAM. Для того чтобы другие пользователи могли получить доступ к Earth Engine через ваш проект, вам потребуется использовать Cloud Console , чтобы предоставить им соответствующие роли и разрешения .

OAuth 2.0 Client ID

Возможно, вам потребуется создать идентификатор клиента OAuth 2.0 из проекта, например, для создания приложения, передающего учетные данные пользователя в Earth Engine. Вы можете управлять учетными данными для своего облачного проекта, перейдя в меню консоли Cloud ( ) и выбрав API и сервисы > Учетные данные . (При появлении запроса выберите проект).

Чтобы создать новый идентификатор клиента для проекта, нажмите + СОЗДАТЬ УЧЕТНЫЕ ДАННЫЕ > Идентификатор клиента OAuth > Веб-приложение .

В конфигурации веб-приложения:

  • Укажите разрешенные источники JavaScript, например: 
http://localhost:8080
https://foo-ee-project.appspot.com
  • Specify authorized redirect URIs, for example: 
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

Узнайте больше об аутентификации пользователей с помощью OAuth .

Типичные сценарии

Я веду образовательный курс...

Отлично! Если вы регистрируете некоммерческий проект, настройка оплаты не требуется. Затем вы можете добавить своих студентов в проект.

Я являюсь частью оперативной группы/коммерческой организации...

Отлично! Вы можете зарегистрировать проект для коммерческого использования и добавить в него своих соавторов. Также обратите внимание на ограничение по количеству рабочих мест в выбранной вами подписке Earth Engine.

Удаление данных Earth Engine

Удаление на уровне учетной записи

Удаление на уровне учетной записи приведет к удалению всех данных Earth Engine из вашей учетной записи.

Если ваша учетная запись входит в организацию Google Workspace, администратор контролирует данные вашей учетной записи. Когда администратор удаляет учетную запись Google , все связанные с ней данные Earth Engine удаляются примерно в течение 30 дней.

Команда Earth Engine не имеет возможности восстановить данные после их удаления.

Облачные проекты

При удалении облачного проекта происходит удаление данных Earth Engine, связанных с этим проектом (включая, например, любые ресурсы, хранящиеся в корне проекта, любые приложения EE уровня проекта, данные мониторинга и т. д.). Этот процесс может быть обратимым в течение 30 дней, но восстановить эти данные по истечении 30 дней невозможно.

Ресурсы

Простейший способ удалить ваши ресурсы — использовать вкладку «Ресурсы» в редакторе кода, чтобы просмотреть и вручную удалить ресурсы Earth Engine.

Для программного удаления актива с идентификатором 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')

Инструмент командной строки

Use the rm command:

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

Скрипты редактора кода

Чтобы удалить скрипты из редактора кода Earth Engine :

Редактор кода

На вкладке «Скрипты» в редакторе кода выберите скрипт или репозиторий и удалите его. После того, как репозиторий будет помечен как удаленный, он становится невосстановимым в течение 30 дней.

Использование Git

Опытные пользователи могут использовать Git для управления своими скриптами. Список доступных репозиториев можно посмотреть по ссылке https://earthengine.googlesource.com/ .

Приложения Earth Engine

Чтобы удалить приложения Earth Engine, используйте кнопку «Приложения» в редакторе кода для управления приложениями .

Для просмотра и удаления ссылок, созданных с помощью функции «Получить ссылку», в редакторе кода используйте страницу «Управление ссылками ». Эта страница доступна по ссылке «Управление ссылками» в выпадающем меню рядом с кнопкой «Получить ссылку».

Configuring noncommercial access

Для организации некоммерческого (бесплатного) доступа к Earth Engine для вашего проекта вам необходимо заполнить регистрационную анкету в консоли Cloud, чтобы подтвердить соответствие вашего проекта требованиям.

Проверка

Поскольку Earth Engine предоставляет бесплатный доступ к большому объему вычислительных ресурсов, Google требует подтверждения каждого проекта, зарегистрированного для некоммерческого использования. Процесс подтверждения осуществляется в рамках регистрации . Если вы заполните анкету подтверждения, и ваш проект будет признан коммерческим, вы не сможете использовать Earth Engine без оплаты.

Начиная с 26 сентября 2025 года, все некоммерческие проекты должны заполнить анкету в консоли Cloud. Мы рекомендуем завершить процесс верификации как можно скорее. Если вы не предпримете никаких действий до 26 сентября 2025 года, доступ вашего проекта к Earth Engine будет приостановлен до завершения процесса верификации.

Реверификация

Всем проектам с некоммерческим доступом необходимо будет периодически подтверждать наличие доступа.

Configuring commercial access

Для настройки коммерческого (платного) доступа к Earth Engine для вашего проекта вам необходимо настроить проект, используя страницу регистрации , и выбрать тарифный план в учетной записи для выставления счетов.

Прекращение коммерческого доступа

Если вы являетесь прямым клиентом Earth Engine и хотите прекратить платное использование Earth Engine, необходимо внести ряд изменений, чтобы избежать начисления платы:

  • Отменить списание средств с подписки

    • Чтобы отменить подписку на Earth Engine в вашем платежном аккаунте, необходимо использовать страницу «Управление планами» (доступна из выпадающего меню настроек пользователя в правом верхнем углу редактора кода при использовании зарегистрированного облачного проекта, связанного с этим платежным аккаунтом).

    • Вы также можете получить прямой доступ к странице «Управление тарифными планами» для своего платежного аккаунта:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID

    • Выбор тарифного плана «Limited» предотвращает начисление каких-либо дополнительных платежей за подписку на платформу Earth Engine после текущего расчетного периода.

  • Остановить расчет платы

    • Чтобы предотвратить новые расходы, связанные с вычислительным временем (EECU-время), отключите API Earth Engine в своих облачных проектах. Обратите внимание, что это не прерывает выполняющиеся запросы и не удаляет сохраненные объекты , поэтому вы все равно можете понести расходы на Earth Engine, даже если API отключен.
    • Информацию об отключении API см. в справке консоли API .

  • Прекратить взимание платы за хранение.

    • Сохраненные ресурсы Earth Engine продолжают приносить доход, даже если API отключен. Удаление ресурсов предотвратит дальнейшие расходы на хранение в EE.