Installazione di NPM

L'API JavaScript di Earth Engine viene distribuita come un pacchetto npm che è 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, quindi configurare le credenziali di autenticazione.

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

Installare la libreria client

1. Configurare Node.js e npm

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

node --version
npm --version

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

2. Installare 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/*. Nei progetti futuri installa il client nello stesso modo.

3. Utilizzare la libreria client in un'applicazione

Nel codice dell'applicazione, richiedi l'API Earth Engine:

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

Aggiornare 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.

Disinstallare la libreria client

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

npm uninstall --save @google/earthengine

Questo comando rimuove node_modules/@google/earthengine dal progetto corrente, ma non influisce sui progetti in altre directory della stessa macchina.

Creare un progetto Cloud e attivare l'API Earth Engine

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

Configurare 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 gli account di servizio. Le app web possono utilizzare uno dei due approcci, con i pro e i contro descritti 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 avere l'autorizzazione per leggere le risorse utilizzate 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 account di servizio

Con l'autenticazione lato server, una chiave privata viene archiviata con l'applicazione, consentendole di accedere all'API Earth Engine tramite un account di servizio. 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 account di servizio, 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);
});

Verificare l'installazione

Per verificare che l'autenticazione sia stata configurata correttamente, esegui il seguente 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, i metadati di un'immagine dovrebbero essere stampati.