Installation de NPM

L'API JavaScript Earth Engine est distribuée en tant que package npm hébergé sur GitHub. Les instructions suivantes donnent un aperçu de l'installation de l'API JavaScript Google Earth Engine. Pour utiliser l'API JavaScript Earth Engine, vous devez installer la bibliothèque cliente et ses dépendances sur votre ordinateur, puis configurer des identifiants d'authentification.

La bibliothèque cliente JavaScript n'inclut pas toutes les fonctionnalités de l'éditeur de code Earth Engine. Notamment, les fonctionnalités d'interface utilisateur telles que les boutons, les panneaux et les graphiques sont exclues.

Installer la bibliothèque cliente

1. Configurer Node.js et npm

npm est un gestionnaire de paquets pour JavaScript et Node.js. Vérifiez que vous disposez de Node.js 6 ou version ultérieure et de npm 3 ou version ultérieure.

node --version
npm --version

Si nécessaire, installez les deux à l'aide du programme d'installation officiel de votre plate-forme.

2. Installer la bibliothèque cliente Earth Engine

La bibliothèque cliente peut être installée à partir de npm avec la commande suivante:

npm install --save @google/earthengine

Une fois installée, la bibliothèque cliente est placée dans le répertoire de projet actuel: node_modules/@google/earthengine/*. Pour les projets futurs, installez le client de la même manière.

3. Utiliser la bibliothèque cliente dans une application

Dans le code de votre application, exigez l'API Earth Engine:

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

Mettre à jour la bibliothèque cliente

npm update @google/earthengine

En savoir plus sur la mise à jour des bibliothèques avec npm

Désinstaller la bibliothèque cliente

Pour désinstaller l'extension à l'aide du gestionnaire de paquets npm, exécutez la commande suivante:

npm uninstall --save @google/earthengine

Cette opération supprime node_modules/@google/earthengine du projet en cours, mais n'a aucune incidence sur les projets d'autres répertoires de la même machine.

Créer un projet Cloud et activer l'API Earth Engine

Suivez ces instructions pour créer un projet Cloud et activer l'API Earth Engine.

Configurer les identifiants d'authentification

Les API Earth Engine utilisent le protocole OAuth 2.0 pour authentifier les clients basés sur un navigateur. Pour l'authentification côté serveur dans Node.js, nous vous recommandons d'utiliser des comptes de service. Les applications Web peuvent utiliser l'une ou l'autre de ces approches, dont les avantages et les inconvénients sont décrits ci-dessous.

Authentification côté client avec OAuth

Avec l'authentification côté client dans un navigateur Web, les utilisateurs de votre application se connectent avec leur propre compte Google. Ces utilisateurs doivent déjà être autorisés à accéder à Earth Engine et doivent disposer de l'autorisation de lire les éléments utilisés par votre application.

Après avoir créé un ID client OAuth 2.0, authentifiez-vous comme indiqué ci-dessous:

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

Authentification côté serveur avec un compte de service

Avec l'authentification côté serveur, une clé privée est stockée avec votre application, ce qui lui permet d'accéder à l'API Earth Engine via un compte de service. Les utilisateurs de votre application n'ont pas besoin de leur propre accès à Earth Engine et ne sont pas tenus de se connecter.

Dans Node.js, seule l'authentification côté serveur est fournie par la bibliothèque cliente.

Après avoir créé un compte de service, utilisez votre clé privée JSON pour vous authentifier:

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

Tester l'installation

Pour vérifier que l'authentification a été correctement configurée, exécutez le script suivant:

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

Si tout est correctement installé, les métadonnées d'une image devraient être imprimées.