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

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

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

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

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

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

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

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

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

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

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

Включить 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 с облачным проектом, выполните HTTP-вызовы с аутентификацией, где аутентификация выполняется с помощью oauth2 . В локальной среде можно использовать команду gcloud . Вы также можете использовать учетную запись службы, связанную с облачным проектом. Пример использования 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

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

Чтобы создать новый идентификатор клиента для проекта, нажмите + СОЗДАТЬ УЧЕТНЫЕ ДАННЫЕ > Идентификатор клиента 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 дней, но восстановить эти данные по истечении этого срока невозможно.

Ресурсы

Самый простой способ удаления ресурсов — использование вкладки «Ресурсы» в редакторе кода для просмотра и ручного удаления ресурсов 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, используйте кнопку «Приложения» в редакторе кода для управления вашими приложениями .

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

Настройка некоммерческого доступа

Чтобы настроить некоммерческий (бесплатный) доступ к 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

    • При выборе плана «Ограниченный» с вашего счета не будут взиматься дальнейшие сборы за подписку на платформу Earth Engine после окончания текущего расчетного периода.

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

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

  • Остановить сборы за хранение

    • Хранение ресурсов Earth Engine продолжает приносить расходы даже при отключении API. Удаление ресурсов избавит вас от необходимости платить дополнительные сборы за хранение EE.