Cloud Assets

Os recursos do Earth Engine (por exemplo, imagens, tabelas) podem ser legados (ou seja, não associados a um projeto do Cloud) ou associados a um projeto do Google Cloud. Neste guia, descrevemos como usar o Gerenciador de recursos para fazer upload e/ou usar recursos associados a um projeto do Google Cloud.

Cloud Asset Manager

O Cloud Asset Manager contém as seções Recursos do Cloud e Recursos legados, além do botão Adicionar um projeto.

Cloud Asset Manager
Figura 1. Gerenciador de recursos do Cloud do editor de código do Earth Engine.

Recursos do Cloud

A seção "Recursos do Cloud" contém recursos que pertencem a qualquer um dos Projetos do Cloud fixados no Gerenciador de recursos. O projeto do Google Cloud selecionado para a sessão do editor de código (indicado na parte superior direita do editor) aparece aqui por padrão. Para fixar outros projetos, escolha o botão Adicionar um projeto e selecione um projeto na caixa de diálogo Selecionar um projeto do Cloud. Os recursos desses projetos vão aparecer em um zippy inicialmente aberto, com pastas aninhadas inicialmente fechadas.

Recursos legados

Os recursos legados são aqueles associados à sua conta do Earth Engine antes da integração do Earth Engine com o Cloud.

Adicionar um projeto

Ao clicar no botão Adicionar um projeto, a caixa de diálogo Selecionar um projeto do Cloud será aberta.

Caixa de diálogo "Selecionar um projeto"
Figura 2. Selecione uma caixa de diálogo do projeto do Cloud.

Essa caixa de diálogo apresenta um menu suspenso para selecionar um projeto do Cloud e mostra os recursos do Earth Engine presentes nele. Os projetos fixados anteriormente são mostrados como Projetos ativados do Earth Engine. Ao selecionar um projeto do Cloud no menu suspenso e clicar em Selecionar, o projeto será fixado na seção "Recursos do Cloud" e os recursos contidos nele serão exibidos.

Selecionar um projeto já fixado vai oferecer a opção de desfazer a fixação.

Como fazer upload de recursos

Faça upload dos recursos usando o botão Fazer upload de recursos. Por padrão, os recursos enviados serão associados ao projeto selecionado no Code Editor. Se você quiser associar os novos recursos a um projeto diferente, selecione outro projeto no seletor de projetos fornecido pela caixa de diálogo de upload.

Gerenciamento de recursos

Os recursos podem ser gerenciados na guia Gerenciador de recursos do Editor de código, na linha de comando, em uma biblioteca de cliente (por exemplo, ee.data.getAsset) ou diretamente na API REST.

Gerenciar permissões de recursos

Para dar a outros usuários acesso aos seus recursos com o objetivo de leitura, gravação ou controle administrativo total, defina permissões no recurso, no projeto ou em ambos. Consulte a página de controle de acesso para mais detalhes.

Como acessar recursos

Os caminhos de recursos estão no formato projects/${PROJECT_NAME}/assets/${ASSET_NAME}. Esses caminhos são usados em construtores de bibliotecas de cliente, ao fazer exportações por uma das bibliotecas de cliente, no momento da ingestão ou do upload e em chamadas da API REST.

Recursos públicos

As imagens no catálogo público podem ser acessadas de caminhos como projects/earthengine-public/assets/path/to/asset/asset-id. Por exemplo, aqui está uma cena do Landsat:

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

Neste exemplo, PROJECT_NAME é earthengine-public. Esses caminhos podem ser transmitidos diretamente para construtores como Image, ImageCollection ou FeatureCollection. Você também transmite caminhos de recursos para a API REST. Aqui está um exemplo muito simples do guia de início rápido do REST.

Recursos pessoais

Para acessar um recurso do Earth Engine armazenado em um projeto de sua propriedade ou que você tem permissão para visualizar, defina PROJECT_NAME como o ID do projeto proprietário do recurso. Exemplo:

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

Neste exemplo, my-ee-enabled-project-id é o nome de um projeto em que os recursos foram enviados ou criados anteriormente. Consulte a página Projetos para mais informações sobre como ativar a API Earth Engine em um projeto do Cloud.

Recursos legados

Os recursos legados são armazenados em pastas legadas users/ ou projects/. Ao acessar esses recursos, o PROJECT_NAME é earthengine-legacy. Exemplo:

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

Como acessar imagens no Cloud Storage

É possível acessar COGs diretamente de um bucket do Cloud Storage usando ee.Image.loadGeoTIFF(). Também é possível criar recursos do Earth Engine com suporte de COG, conforme descrito neste exemplo de API REST.