Доступ к Earth Engine

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

Как получить доступ к Earth Engine

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

Как создать проект

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

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

Действия вручную (автоматизированы на странице регистрации)

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

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

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

Включите Earth Engine API

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

Включите Earth Engine API

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

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

Измените следующий URL для своего проекта, перейдите на страницу и завершите регистрацию.

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

Как создать папку объектов (необязательно)

Вы можете создать папку объектов Earth Engine, связанную с проектом Cloud, к которому у вас есть доступ, с помощью команды 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 с облачным проектом, отправляйте аутентифицированные 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 Console, чтобы предоставить им правильные роли и разрешения.

Идентификатор клиента OAuth 2.0

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

Чтобы создать новый идентификатор клиента для проекта, нажмите + Создать учетные данные > Идентификатор клиента OAuth > Веб-приложение.

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

  • Укажите разрешенные источники JavaScript, например:
http://localhost:8080
https://foo-ee-project.appspot.com
  • Укажите разрешенные URI перенаправления, например:
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 дней после удаления аккаунта его можно восстановить, но по истечении этого срока данные будут утеряны безвозвратно.

Объекты

Самый простой способ удалить объекты – использовать вкладку Assets (Объекты) в редакторе кода Earth Engine для просмотра и ручного удаления объектов 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')

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

Используйте команду rm:

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

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

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

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

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

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

Опытные пользователи могут управлять скриптами с помощью Git. Чтобы посмотреть список доступных вам хранилищ, перейдите на страницу https://earthengine.googlesource.com/.

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

Чтобы удалить приложение Earth Engine, нажмите кнопку Apps (Приложения) в редакторе кода.

Чтобы посмотреть и удалить ссылки, созданные в редакторе кода, используйте страницу Управление ссылками. Чтобы перейти на эту страницу, нажмите на раскрывающееся меню рядом с кнопкой "Получить ссылку" и выберите "Управление ссылками".

Как настроить доступ для некоммерческих организаций

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

Проверка

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

С 26 сентября 2025 года все некоммерческие проекты должны заполнить анкету в Cloud Console. Рекомендуем пройти проверку как можно скорее. Если вы не предпримете действий до 26 сентября 2025 года, доступ к 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.

  • Как остановить начисление платы за вычисления

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

    • Хранение объектов Earth Engine продолжает генерировать расходы, даже если API отключен. Удаление объектов позволяет избежать дальнейших расходов на хранение данных в EE.