Installazione di NPM

L'API JavaScript di Earth Engine viene distribuita come pacchetto npm ospitato su GitHub. Le seguenti istruzioni forniscono una panoramica dell'installazione dell'API JavaScript di Google Earth Engine. Per utilizzare l'API JavaScript di Earth Engine, devi installare la libreria client e le relative dipendenze sul computer e poi configurare le credenziali di autenticazione.

La libreria client JavaScript non include tutte le funzionalità dell'editor di codice di Earth Engine. In particolare, sono escluse le funzionalità dell'interfaccia utente come pulsanti, riquadri e grafici.

Installa la libreria client

1. Configura Node.js e npm

npm è un gestore di pacchetti per JavaScript e Node.js. Verifica di avere Node.js 6 o versioni successive e npm 3 o versioni successive.

node --version
npm --version

Se necessario, installali entrambi utilizzando il programma di installazione ufficiale per la tua piattaforma.

2. Installa la libreria client di Earth Engine

La libreria client può essere installata da npm con il seguente comando:

npm install --save @google/earthengine

Una volta installata, la libreria client viene inserita nella directory del progetto corrente: node_modules/@google/earthengine/*. Per i progetti futuri, installa il client nello stesso modo.

3. Utilizza la libreria client in un'applicazione

All'interno del codice dell'applicazione, richiedi l'API Earth Engine:

var ee = require('@google/earthengine');

Aggiorna la libreria client

Utilizza npm per aggiornare la libreria client all'ultima versione. Dalla directory del progetto corrente:
npm update @google/earthengine

Scopri di più sull'aggiornamento delle librerie con npm.

Disinstalla la libreria client

Per disinstallare utilizzando il gestore di pacchetti npm, esegui questo comando:

npm uninstall --save @google/earthengine

In questo modo node_modules/@google/earthengine viene rimosso dal progetto corrente, ma non vengono interessati i progetti in altre directory sulla stessa macchina.

Crea un progetto Cloud e attiva l'API Earth Engine

Segui queste istruzioni per creare un progetto Cloud e abilitare l'API Earth Engine.

Configura le credenziali di autenticazione

Le API Earth Engine utilizzano il protocollo OAuth 2.0 per l'autenticazione dei client basati su browser. Per l'autenticazione lato server in Node.js, sono consigliati i service account. Le app web possono utilizzare entrambi gli approcci, con i pro e i contro discussi di seguito.

Autenticazione lato client con OAuth

Con l'autenticazione lato client in un browser web, gli utenti della tua applicazione accedono con i propri Account Google. Questi utenti devono essere già autorizzati ad accedere a Earth Engine e devono disporre dell'autorizzazione per leggere gli asset utilizzati dalla tua applicazione.

Dopo aver creato un ID client OAuth 2.0, esegui l'autenticazione come mostrato di seguito (sostituisci my-project con l'ID progetto 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);
});

Autenticazione lato server con un service account

Con l'autenticazione lato server, una chiave privata viene archiviata con l'applicazione, consentendole di accedere all'API Earth Engine tramite un service account. Gli utenti della tua applicazione non hanno bisogno di un proprio accesso a Earth Engine e non sono tenuti ad accedere.

In Node.js, la libreria client fornisce solo l'autenticazione lato server.

Dopo aver creato un nuovo service account, utilizza la chiave privata JSON per l'autenticazione (sostituisci my-project con l'ID progetto 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);
});

Testa l'installazione

Per verificare che l'autenticazione sia stata configurata correttamente, esegui questo script (sostituisci my-project con l'ID progetto 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 tutto è installato correttamente, dovrebbero essere stampati i metadati di un'immagine.