A API JavaScript do Earth Engine é distribuída como um pacote npm hospedado no GitHub. As instruções a seguir oferecem uma visão geral da instalação da API JavaScript do Google Earth Engine. Para usar a API JavaScript do Earth Engine, é necessário instalar a biblioteca de cliente e as dependências dela no computador e, em seguida, configurar as credenciais de autenticação.
A biblioteca de cliente JavaScript não inclui todas as funcionalidades do Editor de código do Earth Engine. Recursos da interface do usuário, como botões, painéis e gráficos, são excluídos.
Instale a biblioteca de cliente
1. Configurar o Node.js e o npm
O npm é um gerenciador de pacotes para JavaScript e Node.js. Verifique se você tem o Node.js 6+ e o npm 3+.
node --version npm --version
Se necessário, instale ambos usando o instalador oficial da sua plataforma.
2. Instalar a biblioteca de cliente do Earth Engine
A biblioteca de cliente pode ser instalada do npm com o seguinte comando:
npm install --save @google/earthengine
Depois de instalada, a biblioteca de cliente é colocada no diretório do projeto atual: node_modules/@google/earthengine/*. Em projetos
futuros, instale o cliente da mesma maneira.
3. Usar a biblioteca de cliente em um aplicativo
No código do aplicativo, solicite a API Earth Engine:
var ee = require('@google/earthengine');
Atualizar a biblioteca de cliente
Use o npm para atualizar a biblioteca de cliente para a versão mais recente. No diretório do projeto atual:npm update @google/earthengine
Saiba mais sobre como atualizar bibliotecas com o npm.
Desinstalar a biblioteca de cliente
Para desinstalar usando o gerenciador de pacotes npm, execute o seguinte comando:
npm uninstall --save @google/earthengine
Isso remove node_modules/@google/earthengine do projeto atual, mas
não afeta nenhum projeto em outros diretórios na mesma máquina.
Criar um projeto na nuvem e ativar a API Earth Engine
Siga estas instruções para criar um projeto do Cloud e ativar a API Earth Engine.
Configurar credenciais de autenticação
As APIs do Earth Engine usam o protocolo OAuth 2.0 para autenticar clientes baseados em navegador. Para autenticação do lado do servidor no Node.js, recomendamos o uso de contas de serviço. Os apps da Web podem usar qualquer uma das abordagens, com prós e contras discutidos abaixo.
Autenticação do lado do cliente com OAuth
Com a autenticação do lado do cliente em um navegador da Web, os usuários do aplicativo fazem login com as próprias Contas do Google. Esses usuários já precisam estar autorizados a acessar o Earth Engine e ter permissão para ler os recursos usados pelo aplicativo.
Depois de criar um ID do cliente OAuth 2.0, faça a autenticação conforme mostrado abaixo (substitua my-project pelo ID do projeto do Google Cloud):
// Load client library. var ee = require('@google/earthengine'); // Initialize client library and run analysis. var initialize = function() { ee.initialize(null, null, function() { // ... run analysis ... }, function(e) { console.error('Initialization error: ' + e); }, null, 'my-project'); }; // Authenticate using an OAuth pop-up. ee.data.authenticateViaOauth(YOUR_CLIENT_ID, initialize, function(e) { console.error('Authentication error: ' + e); }, null, function() { ee.data.authenticateViaPopup(initialize); });
Autenticação do lado do servidor com uma conta de serviço
Com a autenticação do lado do servidor, uma chave privada é armazenada com seu aplicativo, permitindo que ele acesse a API Earth Engine por uma conta de serviço. Os usuários do seu aplicativo não precisam de acesso próprio ao Earth Engine nem de login.
No Node.js, apenas a autenticação do lado do servidor é fornecida pela biblioteca de cliente.
Depois de criar uma nova conta de serviço, use sua chave privada JSON para autenticar (substitua my-project pelo ID do projeto do Google Cloud):
// Require client library and private key. var ee = require('@google/earthengine'); var privateKey = require('./.private-key.json'); // Initialize client library and run analysis. var runAnalysis = function() { ee.initialize(null, null, function() { // ... run analysis ... }, function(e) { console.error('Initialization error: ' + e); }, null, 'my-project'); }; // Authenticate using a service account. ee.data.authenticateViaPrivateKey(privateKey, runAnalysis, function(e) { console.error('Authentication error: ' + e); });
Teste a instalação
Para testar se a autenticação foi configurada corretamente, execute o seguinte script
(substitua my-project pelo ID do projeto do Google Cloud):
var ee = require('@google/earthengine'); // Authenticate using one (but not both) of the methods below. ee.data.authenticateViaOauth(YOUR_CLIENT_ID); ee.data.authenticateViaPrivateKey(YOUR_PRIVATE_KEY); ee.initialize(null, null, null, null, null, 'my-project'); // Run an Earth Engine script. var image = new ee.Image('srtm90_v4'); image.getMap({min: 0, max: 1000}, function(map) { console.log(map); });
Se tudo estiver instalado corretamente, os metadados de uma imagem serão mostrados.