O Earth Engine é executado no Google Cloud e exige projetos do Cloud para acesso e gerenciamento de APIs. Todas as chamadas do Earth Engine (do Editor de código, das bibliotecas de cliente, dos apps ou da API REST) são encaminhadas por um projeto do Cloud, 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 do Cloud que:
- tem a API Earth Engine ativada;
- está registrado para uso comercial ou não comercial, e
- concede a você (ou ao usuário) as funções e permissões corretas.
Criar um projeto
Acesse a página de registro para criar e registrar um novo projeto do Cloud ou registrar um projeto atual.
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 ainda não tiver feito isso, 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 do CloudAtivar 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:
Ativar a API Earth EngineNa página da API Earth Engine, verifique se você selecionou seu projeto e clique no botão ATIVAR.
Registre o projeto para uso comercial ou não comercial
Edite o seguinte URL do 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 aqui.
Exemplo:
earthengine create folder projects/my-project/assets/Você também pode criar uma pasta de recursos para um projeto no Editor de código adicionando o projeto no painel "Recursos".
Você não precisa criar essa pasta, a menos que planeje armazenar recursos no projeto.
Usar um projeto atual
Verifique com a equipe de TI da sua organização sobre os 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 as funções e permissões corretas 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 Python e 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 "Mudar projeto do Cloud" 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ê vai precisar selecionar um projeto para encaminhar 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 do Cloud, 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 do Cloud, emita chamadas HTTP autenticadas em que a autenticação é processada por oauth2. Em um ambiente local, use o comando gcloud. Também é possível usar uma conta de serviço associada a um projeto do Cloud. Consulte o
guia de início rápido da API REST para ver um exemplo de uso de
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 ativados para o Earth Engine 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 principal é 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 Contas de serviço para saber mais sobre o uso delas com o Earth Engine.
Contas do Google
.Os projetos do Google Cloud 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 permissões corretos.
ID de cliente OAuth 2.0
Talvez seja necessário criar um ID do cliente OAuth 2.0 de 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 do Cloud, 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 CREDENCIAIS > ID do cliente OAuth > Aplicativo da Web.
Na configuração do web app:
- Especifique origens JavaScript autorizadas, por exemplo:
http://localhost:8080
https://foo-ee-project.appspot.com
- Especifique 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 educativa...
Ó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 colaboradores a ele. Preste atenção também ao limite de licenças 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 sua conta fizer parte de uma organização do Google Workspace, o administrador controlará os dados dela. Quando um administrador exclui uma Conta do Google, todos os dados associados do Earth Engine são apagados em aproximadamente 30 dias.
A equipe do Earth Engine não consegue 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 revertido 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 ver e excluir manualmente seus recursos do Earth Engine.
Para exclusão programática de um recurso com 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" do Editor de código, selecione um script ou repositório e exclua. Depois que um repositório é marcado como excluído, ele não pode ser recuperado em até 30 dias.
Como usar o Git
Usuários avançados podem usar o Git para gerenciar scripts. Consulte https://earthengine.googlesource.com/ para listar os repositórios que você pode acessar.
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 a "Receber link"
Use a página "Gerenciar links" para conferir e excluir seus links de "Receber 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".
Como configurar o acesso não comercial
Para configurar o acesso não comercial (sem custos financeiros) ao Earth Engine no seu projeto, preencha o questionário de registro no console do Cloud e confirme 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 ter preenchido 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 tomar medidas até 26 de setembro de 2025, o acesso do seu projeto ao Earth Engine será pausado até que você conclua o processo de verificação.
Nova verificação
Todos os projetos com acesso não comercial precisam ser verificados novamente para acesso periodicamente.
Como configurar o acesso comercial
Para configurar o acesso comercial (pago) ao Earth Engine no seu projeto, você precisa configurar o projeto usando a página de registro e escolher um plano na conta de faturamento.
Rescisão do acesso comercial
Se você é um cliente direto do Earth Engine e quer parar de usar o serviço em um contexto pago, é necessário fazer várias mudanças para evitar cobranças:
Interromper as 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 do Cloud registrado e 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 gerar mais taxas de assinatura da plataforma do Earth Engine após o ciclo de faturamento atual.
Interromper cobranças de computação
- Para evitar novas cobranças relacionadas à computação (tempo de EECU), desative a API Earth Engine nos seus projetos do Cloud. Isso não encerra 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 informações sobre como desativar APIs.
Parar as cobranças por armazenamento
- Os recursos armazenados do Earth Engine continuam gerando custos mesmo que a API esteja desativada. Excluir seus recursos evita que você tenha mais taxas de armazenamento do EE.