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:
- tenha a API Earth Engine ativada,
- está registrado para uso comercial ou não comercial; e
- concede a você (ou ao usuário) os papéis e as permissões corretos.
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 nuvemAtivar 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 EngineNa 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-assetScripts 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.
Referências de "Gerar link"
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_IDAo 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.