Os ativos do Earth Engine (por exemplo, imagens, tabelas) podem ser legados (ou seja, não associados a um projeto na nuvem) 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 na nuvem.
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.
Recursos do Cloud
A seção "Recursos do Cloud" contém recursos que pertencem a qualquer um dos projetos na nuvem fixados no Gerenciador de Recursos. O projeto na nuvem selecionado para a sessão do editor de código (conforme indicado no canto superior direito do editor de código) está aqui por padrão. Para fixar outros projetos, clique no botão Adicionar um projeto e selecione um projeto na caixa de diálogo Selecionar um projeto na nuvem. Os recursos desses projetos serão mostrados em um zippy inicialmente expandido, com pastas aninhadas inicialmente recolhidas.
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 na nuvem será aberta.
Essa caixa de diálogo vai apresentar um menu suspenso para selecionar um projeto na nuvem e mostrar os recursos do Earth Engine presentes nesse projeto. Os projetos que você fixou anteriormente são exibidos como Projetos com o Earth Engine Ativado. Selecione um projeto na nuvem no menu suspenso e clique em Selecionar para fixar o projeto na seção "Recursos do Cloud" e mostrar os recursos contidos nele.
Se você selecionar um projeto que já está fixado, vai aparecer a opção de desafixá-lo.
Como fazer upload de recursos
Faça upload de recursos usando o botão Fazer upload de recursos. Por padrão, os recursos enviados serão associados ao projeto selecionado no Editor de Código. Se você quiser que os novos recursos sejam associados a um projeto diferente, selecione um projeto diferente usando o 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 conceder a outros usuários acesso aos seus recursos para leitura, gravação ou controle administrativo total, defina permissões no recurso, no projeto ou em ambos. Consulte a página 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 de API REST.
Recursos públicos
As imagens no catálogo público podem ser acessadas por caminhos como
projects/earthengine-public/assets/path/to/asset/asset-id. Por exemplo, veja 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.
Veja
um exemplo muito simples do guia de início rápido da REST.
Recursos pessoais
Para acessar um recurso do Earth Engine armazenado em um projeto que você possui ou tem permissão para visualizar,
defina PROJECT_NAME como o ID do projeto que possui o 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 na nuvem.
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 GeoTIFFs otimizados para nuvem (COGs, na sigla em inglês) 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 no
guia de registro de COG. Para uma
visão geral, consulte COGs no Earth Engine.