NPM-Installation

Die Earth Engine JavaScript API wird als npm-Paket verteilt, das auf GitHub gehostet wird. In der folgenden Anleitung finden Sie eine Übersicht ü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 Authentifizierungsdaten einrichten.

Die JavaScript-Clientbibliothek enthält nicht alle Funktionen des Code-Editors von Earth Engine. Insbesondere sind Funktionen der Benutzeroberfläche wie Schaltflächen, Bereiche und Diagramme 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 oder höher und npm 3 oder höher 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 über npm installiert werden:

npm install --save @google/earthengine

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

3. Clientbibliothek in einer Anwendung verwenden

Binden Sie die Earth Engine API in Ihren Anwendungscode ein:

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

Clientbibliothek aktualisieren

Verwenden Sie npm, um die Clientbibliothek auf die aktuelle 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 Deinstallation mit dem npm-Paketmanager durchzuführen:

npm uninstall --save @google/earthengine

Dadurch wird node_modules/@google/earthengine aus dem aktuellen Projekt entfernt, aber 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.

Authentifizierungsdaten 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 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 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 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 dabei 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, damit sie über ein Dienstkonto auf die Earth Engine API zugreifen kann. Nutzer Ihrer Anwendung benötigen keinen eigenen Zugriff auf die 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, verwenden Sie Ihren privaten JSON-Schlüssel zur Authentifizierung (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 Script aus, um zu prüfen, ob die Authentifizierung richtig eingerichtet wurde. Ersetzen Sie dabei 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.