Введение
Приложения Earth Engine — это динамические общие пользовательские интерфейсы для анализа Earth Engine. С помощью приложений эксперты могут использовать простые элементы пользовательского интерфейса для использования каталога данных и аналитических возможностей Earth Engine, которые могут использовать как эксперты, так и неспециалисты.
Приложения, опубликованные из Earth Engine, доступны по URL-адресу конкретного приложения, созданному во время публикации. Для просмотра опубликованного приложения или взаимодействия с ним не требуется учетная запись Earth Engine. Приложения, выбранные их создателем в качестве избранных, также доступны в галерее приложений для конкретного пользователя (например, USERNAME.users.earthengine.app).
Создайте свое приложение
Приложения Earth Engine могут использовать большинство тех же функций, что и редактор кода, за некоторыми исключениями. Кроме того, мы разработали API пользовательского интерфейса с учетом требований разработчиков приложений. Если вы новичок в API пользовательского интерфейса, ознакомьтесь с обзором API пользовательского интерфейса .
Публикация вашего приложения
Чтобы опубликовать приложение из редактора кода, сначала загрузите сценарий, который вы хотите создать, в приложение, а затем откройте панель «Управление приложениями», доступ к которой можно получить, нажав кнопку «Приложения» над разделом сценария в редакторе кода.
Затем нажмите кнопку «НОВОЕ ПРИЛОЖЕНИЕ» .
В диалоговом окне выберите доступ к редактору, имя приложения, выберите проект Google Cloud и укажите расположение исходного кода приложения. Ограничьте доступ к этому приложению определенной группой Google или сделайте его общедоступным, используя параметры на вкладке «Ограничение». Для общедоступных приложений вы также можете предоставить собственное изображение предварительного просмотра приложения, а также описание на вкладке «Галерея». Нажмите «Показать это приложение в своей галерее приложений», если вы хотите, чтобы это приложение появилось в вашей общедоступной галерее приложений, доступной по адресу USERNAME.users.earthengine.app . При желании добавьте собственный логотип в верхний левый угол приложения, загрузив изображение по вашему выбору на вкладке «Логотип».
Управление вашими приложениями
Чтобы управлять приложением из редактора кода, откройте панель «Управление приложениями», нажав кнопку «Приложения» над разделом сценариев в редакторе кода. Отсюда вы можете обновить конфигурацию вашего приложения или удалить его.
Сотрудничайте с другими пользователями в приложениях, принадлежащих проекту.
По умолчанию приложения, которые вы публикуете под своим именем пользователя, можете редактировать только вы. Совместная работа над приложениями возможна с помощью приложений, принадлежащих проекту . Приложения, принадлежащие проекту, — это приложения, которые принадлежат и опубликованы в рамках облачного проекта; Любой пользователь с ролью IAM издателя Earth Engine Apps может редактировать и удалять приложения, опубликованные в рамках облачного проекта. Узнайте больше о ролях IAM Earth Engine здесь .
Чтобы включить приложения, принадлежащие проекту, выберите параметр « Облачный проект» на шаге «Выбрать доступ к редактированию» и выберите облачный проект, который вы хотите использовать, а затем завершите процесс публикации приложения как обычно. Приложение будет опубликовано в домене PROJECT-ID.projects.earthengine.app и его сможет редактировать любой, у кого есть роль IAM издателя Earth Engine Apps в облачном проекте.
Чтобы просмотреть приложения для облачного проекта, нажмите кнопку «ДОБАВИТЬ ОБЛАЧНЫЙ ПРОЕКТ» и выберите облачный проект.
Чтобы поделиться облачным проектом с другими, нажмите кнопку ПОДЕЛИТЬСЯ ПРОЕКТОМ . Вы перейдете на страницу IAM Cloud Console для проекта, где сможете предоставить соавторам роль IAM издателя Earth Engine Apps.
Часто задаваемые вопросы
- Как удалить приложение из галереи приложений?
- Флажок «Добавить это приложение» на странице конфигурации приложения определяет, будет ли приложение отображаться на странице «Рекомендуемые приложения». Приложения с ограниченным доступом не могут быть представлены.
- Виден ли мой код Earth Engine?
- Да, всем, кто имеет доступ к приложению. Хотя это не так четко видно, когда ваше приложение опубликовано, кому-то довольно легко просмотреть JavaScript для вашего приложения, наблюдая за сетевым трафиком своего веб-браузера. Например, в Chrome JavaScript можно увидеть, посмотрев на панель «Сеть» инструментов разработчика.
- Каковы возможные причины ошибки «Произошла ошибка при загрузке некоторых частей карты» для опубликованного приложения?
- Убедитесь, что все ресурсы изображений или таблиц, используемые в вашем приложении, доступны публично или в приложении. В диалоговом окне общего доступа к ресурсам выберите параметр «Все могут читать» или выберите имя приложения из раскрывающегося списка. Для приложений, ограниченных группой Google, обмен активом с этой группой Google не сделает его доступным для просмотра в Приложении; вместо этого активы должны быть переданы в приложение или публично.
- Почему я вижу страницу «приложение еще не готово»?
- После создания приложения может пройти некоторое время, прежде чем информация распространится по системе. Обычно проблема решается в течение нескольких минут. Если ошибка не исчезнет, обратитесь за помощью .
- Почему мои нарисованные геометрические фигуры отображаются в моем приложении?
- Это упрощает отображение опорной геометрии в вашем приложении и позволяет создавать приложения, в которых пользователи могут редактировать геометрию. Если вы не хотите, чтобы определенные геометрические объекты отображались или редактировались, вы можете скрыть или заблокировать отдельные слои геометрии, чтобы пользователи не могли видеть или редактировать их перед публикацией вашего приложения. Дополнительную информацию см. в документации по инструментам геометрии .
- Что такое квота приложений?
- Чтобы предотвратить негативное влияние ошибочных или ресурсоемких сценариев на доступность службы, Earth Engine имеет квоты на использование приложений для одновременных запросов. Эта квота действует аналогично квоте Earth Engine на пользователя , за исключением того, что квота привязана к приложению, а не к конкретному пользователю.
- Имеет ли каждое приложение, которое я создаю, свою квоту?
- Да, с каждым приложением связана отдельная квота. Для старых приложений, созданных с помощью ключа API, квота привязана к облачному проекту, из которого вы генерируете ключ API приложения. Если вы создадите несколько ключей API из одного облачного проекта, все они будут использовать одну и ту же квоту использования.
- Зачем нужен платежный аккаунт Cloud? Будет ли с меня взиматься плата за мои приложения?
- Мы используем Google Cloud Platform для решения множества скрытых задач. С вас не будет взиматься плата за создание приложения Earth Engine. Однако Google Cloud Storage не является бесплатным, поэтому если вы решите экспортировать результаты своего анализа в Google Cloud Storage, за это может взиматься дополнительная плата.
- Как мне лучше понять использование приложений и квоты?
Если квота превышена, Earth Engine может вернуть ошибку
HTTP 429: Too Many Requests. Обычно эти ошибки обрабатываются клиентской библиотекой Earth Engine, которая упаковывает запросы в экспоненциальную отсрочку и повторяет запрос до тех пор, пока он не будет успешным. Клиентская библиотека Earth Engine повторит запрос пять раз.Если ваше приложение станет настолько популярным, что многие пользователи получат сообщение об ошибке превышения квоты, пользователи увидят предупреждающее сообщение, и Earth Engine, возможно, придется (временно) ограничить доступ к приложению.
Чтобы избежать получения ошибок 429, вы можете включить кэширование для своего приложения, например, сохраняя кэшируемую совокупную статистику в виде ресурсов таблицы Earth Engine, а не вычисляя ее на лету.