Acesso ao Earth Engine

O Earth Engine é executado no Google Cloud e requer projetos na nuvem para acesso e gerenciamento de APIs. Todas as chamadas do Earth Engine (seja do editor de código, das bibliotecas de cliente, dos apps ou da API REST) são roteadas por um projeto na nuvem, permitindo o controle de acesso, o gerenciamento de recursos e o monitoramento de uso no console do Cloud.

Acessar o Earth Engine

Para usar o Earth Engine, você precisa ter acesso a um projeto na nuvem que:

Criar um projeto

Acesse a página de registro para criar e registrar um novo projeto na nuvem ou registrar um projeto atual. Após o registro, o acesso ao Earth Engine é ativado imediatamente.

Os projetos criados durante o processo de registro podem ser gerenciados no Console do Google Cloud. É possível ativar ou desativar a API Earth Engine na página da API Earth Engine no console do Cloud.

Etapas manuais (automatizadas pela página de registro)

Criar um projeto do Cloud

Se você ainda não tiver um, crie um projeto do Google Cloud. Para isso, acesse a página de projetos do console do Cloud ou clique no botão a seguir:

Criar um projeto na nuvem

Ativar a API Earth Engine

Para ativar a API Earth Engine no seu projeto, clique no botão a seguir para acessar a página da API Earth Engine:

Ativar a API Earth Engine

Na página da API Earth Engine, verifique se você selecionou seu projeto e clique no botão ATIVAR.

Registrar o projeto para uso comercial ou não comercial

Edite o URL a seguir para seu projeto, acesse a página e conclua o fluxo de registro.

https://code.earthengine.google.com/register?project=my-project

Criar uma pasta de recursos (opcional)

É possível criar uma pasta de recursos do Earth Engine associada a um projeto do Cloud a que você tem acesso usando o comando earthengine create folder com um caminho, conforme descrito neste link. Exemplo:

earthengine create folder projects/my-project/assets/

Também é possível criar uma pasta de recursos para um projeto no Editor de código adicionando o projeto no painel "Recursos".

Não é necessário criar essa pasta, a menos que você planeje armazenar recursos no projeto.

Usar um projeto atual

Verifique com a equipe de TI da sua organização se há projetos do Cloud configurados para o Earth Engine. Verifique se a Conta do Google que você vai usar para acessar os serviços do Earth Engine tem os papéis e as permissões corretos no projeto.

Especificar um projeto

As seções a seguir descrevem como especificar um projeto para as várias interfaces dos serviços do Earth Engine.

Bibliotecas de cliente (Python, JavaScript)

A função ee.Initialize() é usada para especificar um projeto para solicitações do Earth Engine originadas das bibliotecas de cliente do Python e do JavaScript. Há várias maneiras de configurar a especificação do projeto. Consulte a página de autenticação e inicialização para mais detalhes.

Editor de código

Clique no ícone de perfil no canto superior direito do Editor de código e selecione "Alterar projeto na nuvem" no menu. Escolha um projeto na caixa de diálogo de seleção.

Apps do Earth Engine

Ao publicar um app do Earth Engine, você precisa selecionar um projeto para rotear as solicitações. Siga as instruções na caixa de diálogo de publicação.

Ferramenta de linha de comando

Para associar chamadas do Earth Engine da ferramenta de linha de comando a um projeto na nuvem, use o parâmetro --project na chamada para earthengine ou use set_project para definir um projeto padrão.

API REST

Para associar chamadas à API REST a um projeto na nuvem, emita chamadas HTTP autenticadas em que a autenticação é processada por oauth2. Em um ambiente local, use o comando gcloud. Você também pode usar uma conta de serviço associada a um projeto na nuvem. Consulte o Guia de início rápido da API REST para ver um exemplo de como usar google.oath.service_account.Credentials.from_service_account_file() para autenticar com uma conta de serviço.

Configurar o acesso ao projeto

As seções a seguir descrevem como configurar projetos com o Earth Engine ativado para uso por outras pessoas e contas de serviço.

Contas de serviço

As contas de serviço têm acesso automático quando o projeto pai é registrado e tem a API Earth Engine ativada. Eles também precisam das permissões corretas no projeto. Qualquer número de contas de serviço em um projeto pode ser configurado para usar o Earth Engine. Acesse a página de contas de serviço para saber mais sobre como usar contas de serviço com o Earth Engine.

Contas do Google

Os projetos na nuvem usam o Cloud IAM para gerenciar papéis e permissões. Para que outras pessoas acessem o Earth Engine pelo seu projeto, use o Console do Cloud para conceder a elas os papéis e as permissões corretos.

ID do cliente OAuth 2.0

Talvez seja necessário criar um ID do cliente OAuth 2.0 em um projeto, por exemplo, para criar um app que transmita as credenciais do usuário para o Earth Engine. Para gerenciar as credenciais do seu projeto na nuvem, acesse o menu do Console do Cloud () e selecione APIs e serviços > Credenciais. Escolha o projeto, se solicitado.

Para criar um novo ID do cliente para o projeto, clique em + CRIAR CREDENCIAS > ID do cliente OAuth > Aplicativo da Web.

Na configuração do aplicativo da Web:

  • Especifique as origens JavaScript autorizadas, por exemplo:
http://localhost:8080
https://foo-ee-project.appspot.com
  • Especifique os URIs de redirecionamento autorizados, por exemplo:
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

Saiba mais sobre como autenticar usuários com o OAuth.

Cenários comuns

Estou uma aula...

Ótimo! Se você registrar um projeto não comercial, não será necessário configurar o faturamento. Em seguida, adicione os estudantes ao projeto.

Faço parte de uma equipe operacional/organização comercial...

Ótimo! Você pode registrar um projeto para uso comercial e adicionar seus colaboradores a ele. Preste atenção também ao limite de usuários na assinatura do Earth Engine que você selecionar.

Exclusão de dados do Earth Engine

Exclusão no nível da conta

A exclusão no nível da conta vai remover todos os dados do Earth Engine da sua conta.

Se a conta fizer parte de uma organização do Google Workspace, o administrador vai controlar os dados da conta. Quando um administrador exclui uma Conta do Google, todos os dados associados do Earth Engine são apagados em aproximadamente 30 dias.

Não é possível para a equipe do Earth Engine recuperar dados depois que eles são excluídos.

Projetos do Cloud

Quando um projeto do Cloud é excluído, isso aciona a exclusão dos dados do Earth Engine associados a ele, incluindo, por exemplo, todos os recursos armazenados na raiz do projeto, todos os apps do EE no nível do projeto, dados de monitoramento etc. Esse processo pode ser reversível por até 30 dias, mas nunca é possível recuperar esses dados após esse período.

Recursos

O método mais simples para excluir seus recursos é usar a guia "Recursos" no editor de código para visualizar e excluir manualmente seus recursos do Earth Engine.

Para exclusão programática de um recurso com o ID projects/{project-id}/assets/{asset-id} (por exemplo, projects/my-project/assets/my-asset):

Cliente Python

ee.data.deleteAsset('projects/my-project/assets/my-asset')

Cliente JavaScript

O sandbox de segurança do Editor de Código impede que essa chamada funcione nesse ambiente.

ee.data.deleteAsset('projects/my-project/assets/my-asset')

Ferramenta de linha de comando

Use o comando rm:

earthengine rm projects/my-project/assets/my-asset

Scripts do editor de código

Para excluir seus scripts do editor de código do Earth Engine:

Editor de código

Na guia "Scripts" no Editor de código, selecione um script ou repositório e exclua-o. Depois que um repositório é marcado como excluído, ele se torna irrecuperável em até 30 dias.

Como usar o Git

Os usuários avançados podem usar o Git para gerenciar os scripts. Acesse https://earthengine.googlesource.com/ para listar os repositórios que você pode visualizar.

Apps do Earth Engine

Para excluir seus apps do Earth Engine, use o botão "Apps" no editor de código para gerenciar seus apps.

Use a página Gerenciar links para conferir e excluir os links "Gerar link" do editor de código. Para acessar essa página, navegue até a opção "Gerenciar links" no menu suspenso ao lado do botão "Gerar link".

Configurar o acesso não comercial

Para configurar o acesso não comercial (sem custo financeiro) do Earth Engine para seu projeto, você precisa preencher o questionário de registro no console do Cloud para confirmar a qualificação do projeto.

Verificação

Como o Earth Engine concede acesso sem custo financeiro a uma grande quantidade de recursos de computação, o Google exige a verificação de cada projeto registrado para acesso não comercial. O processo de verificação é feito como parte do registro. Se você preencher o questionário de verificação e seu projeto for considerado comercial, não será possível usar o Earth Engine sem pagar.

A partir de 26 de setembro de 2025, todos os projetos não comerciais precisarão preencher o questionário no console do Cloud. Recomendamos que você conclua o processo de verificação o mais rápido possível. Se você não entrar em ação antes de 26 de setembro de 2025, o acesso do seu projeto ao Earth Engine será pausado até que o processo de verificação seja concluído.

Nova verificação

Todos os projetos com acesso não comercial precisarão ser verificados novamente de forma periódica.

Configurar o acesso comercial

Para configurar o acesso comercial (pago) do Earth Engine para seu projeto, você precisa configurar o projeto usando a página de registro e escolher um plano na conta de faturamento.

Encerrar o acesso comercial

Se você é um cliente direto do Earth Engine e quer parar de usá-lo em um contexto pago, é necessário fazer várias mudanças para não receber mais cobranças:

  • Interromper cobranças de assinatura

    • Para encerrar a assinatura do Earth Engine na sua conta de faturamento, use a página "Gerenciar planos", acessível no menu suspenso de configurações do usuário no canto superior direito do Editor de código ao usar um projeto na nuvem registrado vinculado a essa conta de faturamento.
    • Também é possível acessar a página "Gerenciar planos" diretamente para uma conta de faturamento:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID
      
    • Ao escolher o plano "Limitado", sua conta de faturamento não vai mais receber cobranças de assinatura da plataforma Earth Engine após o ciclo de faturamento atual.

  • Interromper cobranças de computação

    • Para evitar novas cobranças relacionadas a recursos computacionais (tempo de EECU), desative a API Earth Engine nos seus projetos na nuvem. Isso não encerra as solicitações em andamento nem exclui objetos armazenados. Portanto, você ainda pode receber cobranças do Earth Engine mesmo com a API desativada.
    • Consulte a Ajuda do Console de APIs para saber como desativar APIs.
  • Interromper cobranças de armazenamento

    • Os recursos armazenados do Earth Engine continuam gerando custos mesmo que a API esteja desativada. Excluir seus recursos impede que você pague mais taxas de armazenamento do EE.