Installazione di NPM

L'API JavaScript 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 tuo 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.

Installare la libreria client

1. Configura Node.js e npm

npm è un gestore dei 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, installa 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 posizionata 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');

Aggiornamento della libreria client

npm update @google/earthengine

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

Disinstallazione della libreria client

Per eseguire la disinstallazione utilizzando il gestore dei pacchetti npm, esegui il seguente comando:

npm uninstall --save @google/earthengine

In questo modo, node_modules/@google/earthengine viene rimosso dal progetto corrente, ma non influisce su 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.

Configurazione delle credenziali di autenticazione

Le API Earth Engine utilizzano il protocollo OAuth 2.0 per autenticare i client basati su browser. Per l'autenticazione lato server in Node.js, sono consigliati gli account di servizio. 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 già disporre dell'autorizzazione per accedere a Earth Engine e devono avere l'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:

// 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);
  });
};

// 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 memorizzata nell'applicazione, consentendogli di accedere all'API Earth Engine tramite un account di servizio. Gli utenti della tua applicazione non hanno bisogno di un accesso proprio a Earth Engine e non devono 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:

// 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);
  });
};

// Authenticate using a service account.
ee.data.authenticateViaPrivateKey(privateKey, runAnalysis, function(e) {
  console.error('Authentication error: ' + e);
});

Test dell'installazione

Per verificare che l'autenticazione sia stata configurata correttamente, esegui il seguente script:

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();

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