NPM-Installation

Die Earth Engine JavaScript API wird als npm-Paket auf GitHub gehostet. Die folgende Anleitung gibt 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 Earth Engine Code-Editors. Insbesondere Benutzeroberflächenfunktionen wie Schaltflächen, Panels und Diagramme sind ausgeschlossen.

Clientbibliothek installieren

1. Node.js und npm einrichten

npm ist ein Paketmanager für JavaScript und Node.js. Prüfen Sie, ob Sie Node.js 6+ und npm 3+ haben.

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 von npm installiert werden:

npm install --save @google/earthengine

Nach der Installation wird die Clientbibliothek im aktuellen Projektverzeichnis platziert: node_modules/@google/earthengine/*. Installieren Sie die Clientbibliothek für zukünftige Projekte auf dieselbe Weise.

3. Clientbibliothek in einer Anwendung verwenden

Fordern Sie im Anwendungscode die Earth Engine API an:

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

Clientbibliothek aktualisieren

Verwenden Sie npm, um die Clientbibliothek auf die neueste Version zu aktualisieren. Aus dem 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 Clientbibliothek mit dem npm-Paketmanager zu deinstallieren:

npm uninstall --save @google/earthengine

Dadurch wird node_modules/@google/earthengine aus dem aktuellen Projekt entfernt. Projekte in anderen Verzeichnissen auf demselben Computer sind davon nicht betroffen.

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 Dienst konten empfohlen. Webanwendungen können beide Ansätze verwenden. Die Vor- und Nachteile werden unten erläutert.

Clientseitige Authentifizierung mit OAuth

Bei der clientseitigen Authentifizierung in einem Webbrowser melden sich 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 haben, die von Ihrer Anwendung verwendeten Assets zu lesen.

Nachdem Sie eine OAuth 2.0-Client-ID erstellt haben, authentifizieren Sie sich wie unten gezeigt. Ersetzen Sie my-project durch Ihre Google Cloud-Projekt-ID:

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

Serverseitige Authentifizierung mit einem Dienstkonto

Bei der serverseitigen Authentifizierung wird ein privater Schlüssel in Ihrer Anwendung gespeichert, sodass 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 nur die serverseitige Authentifizierung von der Clientbibliothek bereitgestellt.

Nachdem Sie ein neues Dienstkonto erstellt haben, authentifizieren Sie sich mit Ihrem privaten JSON-Schlüssel. Ersetzen Sie my-project durch Ihre Google Cloud-Projekt-ID:

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

Installation testen

Führen Sie das folgende Skript aus, um zu testen, ob die Authentifizierung korrekt eingerichtet wurde (ersetzen Sie my-project durch Ihre Google Cloud-Projekt-ID):

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

Wenn alles korrekt installiert ist, sollten die Metadaten für ein Bild ausgegeben werden.