Общие сведения об App Engine и Earth Engine

Google App Engine позволяет создавать и запускать собственные приложения на серверах Google. Приложения App Engine легко создавать, поддерживать и масштабировать по мере изменения трафика и потребностей в хранении данных. Вам нужно лишь загрузить исходный код приложения, и оно будет готово к работе. Если вы ещё не разрабатывали приложения для App Engine, ознакомьтесь с кратким руководством по работе с Python или Node.js.

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

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

В каталоге демоверсий Earth Engine App Engine на GitHub есть несколько полезных примеров App Engine. Краткое описание каждого примера можно найти на странице примеров приложений. В этом документе приведены инструкции по настройке и развертыванию примеров или созданных вами приложений.

Развертывание приложений App Engine с помощью Earth Engine

Ниже приведены инструкции по развертыванию демонстрационных приложений. Инструкции по работе с Python предназначены для пользователей Mac OS и Linux. Если вы используете Python в Windows, попробуйте это решение.

Как включить Earth Engine API в облачном проекте Google Cloud

Создайте или выберите облачный проект Google Cloud и включите Earth Engine API, следуя этим инструкциям.

Настройка учетных данных

Сервисный аккаунт

Сервисный аккаунт можно использовать для авторизации запросов к Earth Engine от имени любого пользователя вашего приложения. Файл config.py содержит код аутентификации, в котором используется адрес электронной почты сервисного аккаунта и файл закрытого ключа. Чтобы настроить аутентификацию с помощью сервисного аккаунта, следуйте этим инструкциям, чтобы создать сервисный аккаунт и файл закрытого ключа. Назовите файл ключа .private-key.json и переместите его в каталог проекта.

Python

Если вы ещё этого не сделали, настройте Earth Engine Python API. Протестируйте сервисный аккаунт, следуя этим инструкциям.

Если проверка прошла успешно, укажите адрес электронной почты сервисного аккаунта в файле config.py или аналогичном файле в исходном коде. (Путь к файлу ключа не должен измениться, поскольку он находится в каталоге проекта).

Node.js

Установите зависимости проекта, выполнив команду npm install. Earth Engine Node.js API и все другие зависимости будут скопированы в папку ./node_modules в каталоге проекта. Если установить не удается, проверьте, установлена ли последняя версия Node.js. Выполните аутентификацию и инициализируйте библиотеку, заменив my-project идентификатором проекта Google Cloud.

const ee = require('@google/earthengine');
ee.data.authenticateViaPrivateKey('.private-key.json');
ee.initialize(null, null, null, null, null, 'my-project');

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

Если вы хотите, чтобы пользователи проходили аутентификацию от своего имени (а не с помощью сервисного аккаунта), вам нужно настроить идентификатор клиента OAuth в облачном проекте. Вот как это сделать:

  1. Настройте идентификатор клиента, следуя этим инструкциям.
  2. Обновите файл static/script.js (или аналогичный файл в исходном коде), чтобы использовать идентификатор клиента.
  3. Убедитесь, что файл ee_api_js.js доступен в каталоге /static/ (или аналогичном). Вы можете скачать его напрямую с GitHub, установить из npm или, если вы уже клонировали весь репозиторий EE API, скопировать из earthengine-api/javascript/build в локальной файловой системе.

Настройте локальную среду разработки

Python

Чтобы скачать и собрать проект, следуйте инструкциям в каталоге каждого примера на GitHub. Если файл build.sh существует, запустите его из корневой папки приложения с помощью команды:

./build.sh

Скрипт настройки скачает зависимости и установит инструменты командной строки Google, если их ещё нет в вашей системе. Earth Engine Python API и его зависимости будут скопированы в папку ./lib в каталоге проекта.

Убедитесь, что инструменты командной строки App Engine доступны, выполнив следующую команду:

dev_appserver.py

Если команда не найдена, попробуйте вручную скачать и установить Google App Engine SDK для Python. Если команда доступна, должно появиться сообщение об ошибке "error: too few arguments".

Node.js

Настройка не требуется.

Локальный запуск

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

Python
dev_appserver.py .
Node.js
npm install
npm start

Чтобы посмотреть, как приложение работает на локальном сервере, перейдите по адресу http://localhost:8080. Все внесенные и сохраненные изменения будут автоматически применены после обновления страницы.