NPM-Installation

Die Earth Engine JavaScript API wird als npm-Paket verteilt, das auf GitHub gehostet wird. In der folgenden Anleitung erhalten Sie einen Überblick über die Installation der Google Earth Engine JavaScript API. Wenn Sie die Earth Engine JavaScript API verwenden möchten, müssen Sie die Clientbibliothek und ihre Abhängigkeiten auf Ihrem Computer installieren und dann Anmeldedaten für die Authentifizierung einrichten.

Die JavaScript-Clientbibliothek enthält nicht alle Funktionen des Code-Editors von Earth Engine. Insbesondere sind Funktionen der Benutzeroberfläche wie Schaltflächen, Steuerfelder und Diagramme ausgeschlossen.

Clientbibliothek installieren

1. Node.js und npm einrichten

npm ist ein Paketmanager für JavaScript und Node.js. Sie benötigen Node.js 6 oder höher und npm 3 oder höher.

node --version
npm --version

Installieren Sie bei Bedarf beide mit dem offiziellen Installationsprogramm für Ihre Plattform.

2. Earth Engine-Clientbibliothek installieren

Die Clientbibliothek kann mit dem folgenden Befehl über npm installiert werden:

npm install --save @google/earthengine

Nach der Installation wird die Clientbibliothek im aktuellen Projektverzeichnis node_modules/@google/earthengine/* abgelegt. Installieren Sie den Client bei zukünftigen Projekten auf die gleiche Weise.

3. Clientbibliothek in einer Anwendung verwenden

Erforderlichen Sie die Earth Engine API in Ihrem Anwendungscode:

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

Clientbibliothek aktualisieren

Aktualisieren Sie die Clientbibliothek mit npm auf die neueste Version. Im aktuellen Projektverzeichnis: 
npm update @google/earthengine

Weitere Informationen zum Aktualisieren von Bibliotheken mit npm

Clientbibliothek deinstallieren

Führen Sie den folgenden Befehl aus, um die Deinstallation mit dem npm-Paketmanager auszuführen:

npm uninstall --save @google/earthengine

Dadurch wird node_modules/@google/earthengine aus dem aktuellen Projekt entfernt, hat aber keine Auswirkungen auf Projekte in anderen Verzeichnissen auf demselben Computer.

Cloud-Projekt erstellen und Earth Engine API aktivieren

Folgen Sie dieser Anleitung, um ein Cloud-Projekt zu erstellen und die Earth Engine API zu aktivieren.

Anmeldedaten für die Authentifizierung einrichten

Earth Engine APIs verwenden das OAuth 2.0-Protokoll zur Authentifizierung browserbasierter Clients. Für die serverseitige Authentifizierung in Node.js werden Dienstkonten empfohlen. Web-Apps können entweder den serverseitigen oder den clientseitigen Ansatz verwenden. Die Vor- und Nachteile werden unten erläutert.

Clientseitige Authentifizierung mit OAuth

Bei der clientseitigen Authentifizierung in einem Webbrowser melden sich die Nutzer Ihrer Anwendung mit ihren eigenen Google-Konten an. Diese Nutzer müssen bereits für den Zugriff auf Earth Engine autorisiert sein und die Berechtigung zum Lesen der von Ihrer Anwendung verwendeten Assets haben.

Nachdem du eine OAuth 2.0-Client-ID erstellt hast, authentifiziere dich wie unten gezeigt:

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

Serverseitige Authentifizierung mit einem Dienstkonto

Bei der serverseitigen Authentifizierung wird ein privater Schlüssel in Ihrer Anwendung gespeichert, damit sie über ein Dienstkonto auf die Earth Engine API zugreifen kann. Nutzer Ihrer Anwendung benötigen keinen eigenen Zugriff auf Earth Engine und müssen sich nicht anmelden.

In Node.js wird von der Clientbibliothek nur die serverseitige Authentifizierung bereitgestellt.

Nachdem Sie ein neues Dienstkonto erstellt haben, können Sie mit Ihrem privaten JSON-Schlüssel Folgendes authentifizieren:

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

Installation testen

Führen Sie das folgende Script aus, um zu prüfen, ob die Authentifizierung korrekt eingerichtet wurde:

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

Wenn alles richtig installiert ist, sollten die Metadaten für ein Bild gedruckt werden.

.