Cloud Assets

Активы Earth Engine (например, изображения, таблицы) могут быть устаревшими активами (т. е. не связанными с облачным проектом) или активами, связанными с проектом Google Cloud . В этом руководстве описывается, как использовать Asset Manager для загрузки и/или использования активов, связанных с облачным проектом.

Менеджер облачных активов

Cloud Asset Manager содержит раздел Cloud Assets , раздел Legacy Assets и кнопку Add A Project .

Менеджер облачных активов
Рисунок 1. Cloud Asset Manager редактора кода Earth Engine.

Облачные активы

Раздел «Облачные ресурсы» содержит ресурсы, относящиеся к любому из облачных проектов, закреплённых в диспетчере ресурсов. Облачный проект, выбранный для сеанса редактора кода (как указано в правом верхнем углу редактора кода), отображается здесь по умолчанию. Дополнительные проекты можно закрепить, нажав кнопку «Добавить проект» и выбрав проект в диалоговом окне «Выбрать облачный проект» . Ресурсы этих проектов будут отображаться в изначально развёрнутом архиве, а вложенные папки — в свёрнутом виде.

Устаревшие активы

Устаревшие активы — это активы, связанные с вашей учетной записью Earth Engine до интеграции Earth Engine Cloud.

Добавить проект

Нажатие кнопки «Добавить проект» откроет диалоговое окно «Выбрать облачный проект» .

Диалог выбора проекта
Рисунок 2. Диалог выбора облачного проекта.

В этом диалоговом окне представлен раскрывающийся список для выбора облачного проекта и отображаются ресурсы Earth Engine, присутствующие в этом проекте. Ранее закреплённые проекты отображаются как «Проекты с поддержкой Earth Engine» . Выбор облачного проекта в раскрывающемся списке и нажатие кнопки «Выбрать» закрепит проект в разделе «Облачные ресурсы» и отобразит содержащиеся в нём ресурсы.

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

Загрузка активов

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

Управление активами

Управлять активами можно через вкладку «Менеджер активов» редактора кода, командную строку , клиентскую библиотеку (например, ee.data.getAsset ) или напрямую через REST API .

Управление разрешениями на активы

Чтобы предоставить другим пользователям доступ к вашим ресурсам для чтения, записи или полного административного управления, вы можете установить разрешения для ресурса, проекта или для обоих. Подробнее см. на странице «Управление доступом» .

Доступ к активам

Пути к ресурсам имеют вид projects/${PROJECT_NAME}/assets/${ASSET_NAME} . Эти пути используются в конструкторах клиентских библиотек, при экспорте через одну из клиентских библиотек, при загрузке или загрузке, а также в вызовах REST API.

Государственные активы

Доступ к изображениям в публичном каталоге можно получить по следующим путям: projects/earthengine-public/assets/path/to/asset/asset-id . Например, вот сцена Landsat :

projects/earthengine-public/assets/LANDSAT/LC08/C02/T1_RT/LC08_001004_20140609

Обратите внимание, что PROJECT_NAME в этом примере — earthengine-public . Эти пути можно передавать напрямую конструкторам, таким как Image , ImageCollection или FeatureCollection . Пути к ресурсам также передаются в REST API. Вот очень простой пример из краткого руководства по REST.

Личные активы

Чтобы получить доступ к ресурсу Earth Engine, хранящемуся в проекте, владельцем которого вы являетесь или на просмотр которого у вас есть разрешение, укажите в качестве значения PROJECT_NAME идентификатор проекта, которому принадлежит этот ресурс. Например:

projects/my-ee-enabled-project-id/assets/my-asset-id

В этом примере my-ee-enabled-project-id — это имя проекта, в котором ранее были загружены или созданы ресурсы. Подробнее о включении API Earth Engine в облачном проекте см. на странице «Проекты» .

Устаревшие активы

Устаревшие ресурсы — это ресурсы, хранящиеся в папках users/ или projects/ . При доступе к этим ресурсам PROJECT_NAMEearthengine-legacy . Например:

projects/earthengine-legacy/assets/users/user-name/my-asset-id

Доступ к изображениям в облачном хранилище

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