Earth Engine-Zugriff

Earth Engine wird in Google Cloud ausgeführt und erfordert Cloud-Projekte für den Zugriff und die API-Verwaltung. Alle Earth Engine-Aufrufe (ob über den Code-Editor, Clientbibliotheken, Apps oder die REST API) werden über ein Cloud-Projekt weitergeleitet. Dadurch sind Zugriffssteuerung, Ressourcenverwaltung und Nutzungsmonitoring in der Cloud Console möglich.

Zugriff auf die Earth Engine erhalten

Wenn Sie Earth Engine verwenden möchten, benötigen Sie Zugriff auf ein Cloud-Projekt, das:

Projekt erstellen

Rufen Sie die Registrierungsseite auf, um ein neues Cloud-Projekt zu erstellen und zu registrieren oder ein vorhandenes Projekt zu registrieren. Nach der Registrierung wird der Zugriff auf die Earth Engine sofort aktiviert.

Projekte, die während der Registrierung erstellt wurden, können in der Google Cloud Console verwaltet werden. Sie können die Earth Engine API auf der Seite „Earth Engine API“ in der Cloud Console aktivieren oder deaktivieren.

Manuelle Schritte (automatisiert durch die Registrierungsseite)

Cloud-Projekt erstellen

Erstellen Sie ein Google Cloud-Projekt, falls noch nicht geschehen. Dies ist auf der Projektseite der Cloud Console möglich. Sie können aber auch auf den folgenden Button klicken:

Cloud-Projekt erstellen

Earth Engine API aktivieren

Klicken Sie auf den folgenden Button, um die Earth Engine API für Ihr Projekt zu aktivieren und die Seite „Earth Engine API“ aufzurufen:

Earth Engine API aktivieren

Achten Sie darauf, dass Sie auf der Seite der Earth Engine API Ihr Projekt ausgewählt haben, und klicken Sie auf den Button AKTIVIEREN.

Projekt für die kommerzielle oder nicht kommerzielle Nutzung registrieren

Bearbeiten Sie die folgende URL für Ihr Projekt, rufen Sie die Seite auf und schließen Sie die Registrierung ab.

https://code.earthengine.google.com/register?project=my-project

Asset-Ordner erstellen (optional)

Sie können einen Earth Engine-Asset-Ordner erstellen, der mit einem Cloud-Projekt verknüpft ist, auf das Sie Zugriff haben. Verwenden Sie dazu den Befehl earthengine create folder mit einem Pfad, wie hier beschrieben. Beispiel:

earthengine create folder projects/my-project/assets/

Sie können im Code-Editor auch einen Asset-Ordner für ein Projekt erstellen, indem Sie das Projekt im Bereich „Assets“ hinzufügen.

Sie müssen diesen Ordner nur erstellen, wenn Sie Assets im Projekt speichern möchten.

Vorhandenes Projekt verwenden

Erkundigen Sie sich bei der IT-Abteilung Ihrer Organisation nach vorhandenen Cloud-Projekten, die für die Earth Engine konfiguriert sind. Achten Sie darauf, dass dem Google-Konto, mit dem Sie auf Earth Engine-Dienste zugreifen, die richtigen Rollen und Berechtigungen für das Projekt zugewiesen sind.

Projekt angeben

In den folgenden Abschnitten wird beschrieben, wie Sie ein Projekt für die verschiedenen Schnittstellen zu den Earth Engine-Diensten angeben.

Clientbibliotheken (Python, JavaScript)

Mit der Funktion ee.Initialize() wird ein Projekt für Earth Engine-Anfragen angegeben, die von den Python- und JavaScript-Clientbibliotheken stammen. Es gibt mehrere Möglichkeiten, die Projektspezifikation zu konfigurieren. Weitere Informationen finden Sie auf der Seite Authentifizierung und Initialisierung.

Code-Editor

Klicken Sie im Code-Editor rechts oben auf das Profilsymbol und wählen Sie im Menü „Cloud-Projekt ändern“ aus. Wählen Sie im Auswahldialogfeld ein Projekt aus.

Earth Engine-Apps

Wenn Sie eine Earth Engine-App veröffentlichen, werden Sie aufgefordert, ein Projekt auszuwählen, über das Anfragen weitergeleitet werden sollen. Folgen Sie der Anleitung im Dialogfeld zum Veröffentlichen.

Befehlszeilentool

Wenn Sie Earth Engine-Aufrufe über das Befehlszeilentool mit einem Cloud-Projekt verknüpfen möchten, verwenden Sie den Parameter --project in Ihrem Aufruf von earthengine oder legen Sie mit set_project ein Standardprojekt fest.

REST API

Wenn Sie Aufrufe der REST API mit einem Cloud-Projekt verknüpfen möchten, müssen Sie authentifizierte HTTP-Aufrufe ausführen, bei denen die Authentifizierung von oauth2 übernommen wird. In einer lokalen Umgebung können Sie den Befehl gcloud verwenden. Sie können auch ein Dienstkonto verwenden, das mit einem Cloud-Projekt verknüpft ist. In der REST API-Kurzanleitung finden Sie ein Beispiel für die Verwendung von google.oath.service_account.Credentials.from_service_account_file() zur Authentifizierung mit einem Dienstkonto.

Projektzugriff konfigurieren

In den folgenden Abschnitten wird beschrieben, wie Sie Earth Engine-fähige Projekte für die Verwendung durch andere Personen und Dienstkonten konfigurieren.

Dienstkonten

Dienstkonten haben automatisch Zugriff, sobald ihr übergeordnetes Projekt registriert und die Earth Engine API aktiviert ist. Außerdem benötigen sie die richtigen Berechtigungen im Projekt. Eine beliebige Anzahl von Dienstkonten in einem Projekt kann für die Verwendung von Earth Engine konfiguriert werden. Weitere Informationen zur Verwendung von Dienstkonten mit Earth Engine finden Sie auf der Seite Dienstkonten.

Google-Konten

In Cloud-Projekten werden Rollen und Berechtigungen mit Cloud IAM verwaltet. Damit andere Personen über Ihr Projekt auf Earth Engine zugreifen können, müssen Sie ihnen in der Cloud Console die entsprechenden Rollen und Berechtigungen zuweisen.

OAuth 2.0-Client-ID

Möglicherweise müssen Sie eine OAuth 2.0-Client-ID aus einem Projekt erstellen, z. B. um eine App zu erstellen, die Nutzeranmeldedaten an Earth Engine übergibt. Sie können die Anmeldedaten für Ihr Cloud-Projekt verwalten, indem Sie im Menü der Cloud Console () die Option APIs und Dienste > Anmeldedaten auswählen. (Wählen Sie das Projekt aus, wenn Sie dazu aufgefordert werden.)

Klicken Sie auf + ANMELDEDATEN ERSTELLEN > OAuth-Client-ID > Webanwendung, um eine neue Client-ID für das Projekt zu erstellen.

In der Konfiguration der Webanwendung:

  • Geben Sie autorisierte JavaScript-Quellen an, z. B.:
http://localhost:8080
https://foo-ee-project.appspot.com
  • Geben Sie autorisierte Weiterleitungs-URIs an, z. B.:
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

Weitere Informationen zur Authentifizierung von Nutzern mit OAuth

Häufige Szenarien

Ich unterrichte eine Klasse…

Sehr gut! Wenn Sie ein nicht kommerzielles Projekt registrieren, ist keine Abrechnungskonfiguration erforderlich. Anschließend können Sie Ihre Schüler/Studenten zum Projekt hinzufügen.

Ich bin Teil eines operativen Teams/einer kommerziellen Organisation…

Sehr gut! Sie können ein Projekt für die kommerzielle Nutzung registrieren und Ihre Mitbearbeiter hinzufügen. Achten Sie auch auf die maximale Anzahl von Nutzern im ausgewählten Earth Engine-Abo.

Löschen von Earth Engine-Daten

Löschen auf Kontoebene

Durch das Löschen auf Kontoebene werden alle Earth Engine-Daten aus Ihrem Konto entfernt.

Wenn Ihr Konto Teil einer Google Workspace-Organisation ist, werden Ihre Kontodaten von Ihrem Administrator verwaltet. Wenn ein Administrator ein Google-Konto löscht, werden alle zugehörigen Earth Engine-Daten innerhalb von etwa 30 Tagen gelöscht.

Das Earth Engine-Team kann gelöschte Daten nicht wiederherstellen.

Cloudprojekte

Wenn ein Cloud-Projekt gelöscht wird, werden auch die mit diesem Projekt verknüpften Earth Engine-Daten gelöscht. Dazu gehören beispielsweise alle im Projektstamm gespeicherten Assets, alle EE-Apps auf Projektebene und Monitoring-Daten. Dieser Vorgang kann bis zu 30 Tage lang rückgängig gemacht werden. Nach 30 Tagen ist es jedoch nicht mehr möglich, diese Daten wiederherzustellen.

Assets

Die einfachste Methode zum Löschen Ihrer Assets ist die Verwendung des Tabs „Assets“ im Code-Editor. Dort können Sie Ihre Earth Engine-Assets aufrufen und manuell löschen.

Für das programmatische Löschen eines Assets mit der ID projects/{project-id}/assets/{asset-id} (z.B. projects/my-project/assets/my-asset):

Python-Client

ee.data.deleteAsset('projects/my-project/assets/my-asset')

JavaScript-Client

Beachten Sie, dass dieser Aufruf aufgrund der Sicherheits-Sandbox des Code-Editors in dieser Umgebung nicht funktioniert.

ee.data.deleteAsset('projects/my-project/assets/my-asset')

Befehlszeilentool

Führen Sie den Befehl rm aus:

earthengine rm projects/my-project/assets/my-asset

Code-Editor-Skripts

So löschen Sie Ihre Earth Engine-Code-Editor-Skripts:

Code-Editor

Wählen Sie im Code-Editor auf dem Tab Scripts ein Script oder Repository aus und löschen Sie es. Sobald ein Repository als gelöscht markiert wurde, kann es innerhalb von 30 Tagen nicht mehr wiederhergestellt werden.

Git verwenden

Fortgeschrittene Nutzer können Git verwenden, um ihre Skripts zu verwalten. Unter https://earthengine.googlesource.com/ finden Sie eine Liste der Repositories, die Sie sich ansehen können.

Earth Engine-Apps

Wenn Sie Ihre Earth Engine-Apps löschen möchten, verwenden Sie im Code-Editor die Schaltfläche „Apps“, um Ihre Apps zu verwalten.

Auf der Seite Links verwalten können Sie Ihre „Link abrufen“-Links aus dem Code-Editor ansehen und löschen. Sie finden diese Seite, indem Sie im Drop-down-Menü neben der Schaltfläche „Link abrufen“ die Option Links verwalten auswählen.

Nicht kommerziellen Zugriff konfigurieren

Wenn Sie für Ihr Projekt einen nicht kommerziellen (kostenlosen) Earth Engine-Zugriff einrichten möchten, müssen Sie den Registrierungsfragebogen in der Cloud Console ausfüllen, um die Berechtigung Ihres Projekts zu bestätigen.

Bestätigung

Da die Earth Engine kostenlosen Zugriff auf eine große Menge an Rechenressourcen bietet, verlangt Google eine Überprüfung jedes Projekts, das für den nicht kommerziellen Zugriff registriert ist. Die Überprüfung erfolgt im Rahmen der Registrierung. Wenn Sie den Fragebogen zur Bestätigung ausfüllen und Ihr Projekt als kommerziell eingestuft wird, können Sie die Earth Engine nicht kostenlos nutzen.

Ab dem 26. September 2025 müssen alle nicht kommerziellen Projekte den Fragebogen in der Cloud Console ausgefüllt haben. Wir empfehlen, die Überprüfung so schnell wie möglich abzuschließen. Wenn Sie bis zum 26. September 2025 keine Maßnahmen ergreifen, wird der Zugriff Ihres Projekts auf die Earth Engine pausiert, bis Sie die Überprüfung abgeschlossen haben.

Erneute Bestätigung

Alle Projekte mit nicht kommerziellem Zugriff müssen regelmäßig neu bestätigt werden.

Kommerziellen Zugriff konfigurieren

Wenn Sie für Ihr Projekt einen kommerziellen (kostenpflichtigen) Earth Engine-Zugriff einrichten möchten, müssen Sie das Projekt über die Registrierungsseite konfigurieren und einen Tarif für das Rechnungskonto auswählen.

Kommerziellen Zugriff beenden

Wenn Sie ein direkter Kunde von Earth Engine sind und Earth Engine nicht mehr in einem kostenpflichtigen Kontext verwenden möchten, müssen Sie mehrere Änderungen vornehmen, damit keine Kosten mehr anfallen:

  • Abogebühren stoppen

    • Wenn Sie das Earth Engine-Abo für Ihr Rechnungskonto kündigen möchten, müssen Sie die Seite „Abos verwalten“ verwenden. Diese finden Sie im Drop-down-Menü „Nutzereinstellungen“ oben rechts im Code-Editor, wenn Sie ein registriertes Cloud-Projekt verwenden, das mit diesem Rechnungskonto verknüpft ist.
    • Sie können die Seite „Tarife verwalten“ auch direkt für ein Rechnungskonto aufrufen:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID
      
    • Wenn Sie das Abo „Eingeschränkt“ auswählen, fallen für Ihr Rechnungskonto nach dem aktuellen Abrechnungszeitraum keine weiteren Abogebühren für die Earth Engine-Plattform an.

  • Compute-Gebühren beenden

    • Wenn Sie neue Gebühren im Zusammenhang mit der Rechenleistung (EECU-Zeit) vermeiden möchten, deaktivieren Sie die Earth Engine API in Ihren Cloud-Projekten. Beachten Sie, dass dadurch laufende Anfragen nicht beendet und gespeicherte Objekte nicht gelöscht werden. Daher können auch bei deaktivierter API weiterhin Earth Engine-Gebühren anfallen.
    • Informationen zum Deaktivieren von APIs finden Sie in der API Console-Hilfe.
  • Speichergebühren beenden

    • Gespeicherte Earth Engine-Assets verursachen auch dann Kosten, wenn die API deaktiviert ist. Wenn Sie Ihre Assets löschen, fallen keine weiteren EE-Speichergebühren an.