Earth Engine-Zugriff

Earth Engine wird in der Google Cloud ausgeführt und erfordert Cloud-Projekte für den Zugriff und die API-Verwaltung. Alle Earth Engine-Aufrufe (ob aus dem Code-Editor, Clientbibliotheken, Apps oder der REST API) werden über ein Cloud-Projekt weitergeleitet. So können Sie in der Cloud Console die Zugriffssteuerung, Ressourcenverwaltung und Nutzungsüberwachung nutzen.

Zugriff auf Earth Engine erhalten

Für die Verwendung von Earth Engine benötigen Sie Zugriff auf ein Cloud-Projekt, das folgende Voraussetzungen erfüllt:

Projekt erstellen

Auf der Registrierungsseite können Sie ein neues Cloud-Projekt erstellen und registrieren oder ein vorhandenes Projekt registrieren. Nach der Registrierung wird der Zugriff auf 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 (werden von der Registrierungsseite automatisiert)

Cloud-Projekt erstellen

Erstellen Sie ein Google Cloud-Projekt, falls noch nicht geschehen. Sie können dies auf der Seite „Projekte“ in der Cloud Console tun oder auf die folgende Schaltfläche klicken:

Cloud-Projekt erstellen

Earth Engine API aktivieren

Klicken Sie auf die folgende Schaltfläche, um die Earth Engine API für Ihr Projekt zu aktivieren:

Earth Engine API aktivieren

Achten Sie auf der Seite „Earth Engine API“ darauf, dass Ihr Projekt ausgewählt ist, und klicken Sie auf die Schaltfläche „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 führen Sie die Registrierung durch. 

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 earthengine create folder Befehl mit einem Pfad wie hier beschrieben. Beispiel: 

earthengine create folder projects/my-project/assets/

Sie können auch einen Asset-Ordner für ein Projekt im Code-Editor 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

Fragen Sie die IT-Abteilung Ihrer Organisation nach vorhandenen Cloud-Projekten, die für 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 gewährt wurden.

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 ee.Initialize() Funktion wird ein Projekt für Earth Engine Anfragen angegeben, die von den Python und JavaScript Client Bibliotheken stammen. Es gibt mehrere Möglichkeiten, die Projektspezifikation zu konfigurieren. Weitere Informationen finden Sie auf der Authentifizierungs- und Initialisierungsseite.

Code-Editor

Klicken Sie rechts oben im Code-Editor auf das Profilsymbol und wählen Sie im Menü „Cloud-Projekt ändern“ aus. Wählen Sie im Auswahlfenster 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 Veröffentlichungsdialog.

Befehlszeilentool

Wenn Sie Earth Engine-Aufrufe aus dem Befehlszeilentool mit einem Cloud-Projekt verknüpfen möchten, verwenden Sie den --project Parameter 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, führen Sie authentifizierte HTTP-Aufrufe aus, bei denen die Authentifizierung von oauth2 übernommen wird. In einer lokalen Umgebung, können Sie den gcloud Befehl verwenden. Sie können auch ein Dienstkonto verwenden, das mit einem Cloud-Projekt verknüpft ist. Im REST API-Schnellstart finden Sie ein Beispiel für die Authentifizierung mit einem Dienstkonto mithilfe von google.oath.service_account.Credentials.from_service_account_file().

Projektzugriff konfigurieren

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

Dienstkonten

Dienstkonten haben automatisch Zugriff, sobald ihr übergeordnetes Projekt registriert ist und die Earth Engine API aktiviert ist. Sie benötigen außerdem 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. Wenn andere Personen über Ihr Projekt auf Earth Engine zugreifen sollen, müssen Sie ihnen in der Cloud Console die richtigen Rollen und Berechtigungen gewähren.

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 in der Cloud Console auf das Menü () klicken und APIs und Dienste > Anmeldedaten auswählen. Wählen Sie das Projekt aus, wenn Sie dazu aufgefordert werden.

Klicken Sie zum Erstellen einer neuen Client-ID für das Projekt auf + ANMELDEDATEN ERSTELLEN > OAuth-Client-ID > Webanwendung.

Konfigurieren Sie die Webanwendung so:

  • 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 in einem Kurs...

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

Ich bin Teil eines Betriebsteams/einer kommerziellen Organisation...

Sehr gut! Sie können ein Projekt für die kommerzielle Nutzung registrieren und Ihre Mitarbeiter hinzufügen. Beachten Sie auch das Nutzerlimit im ausgewählten Earth Engine-Abo.

Earth Engine-Daten löschen

Löschen auf Kontoebene

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

Wenn Ihr Konto Teil einer Google Workspace-Organisation ist, verwaltet Ihr Administrator Ihre Kontodaten. 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 Daten nach dem Löschen nicht wiederherstellen.

Cloudprojekte

Wenn ein Cloud-Projekt gelöscht wird, werden auch die mit diesem Projekt verknüpften Earth Engine-Daten gelöscht (z. B. alle Assets, die im Projektstamm gespeichert sind, alle EE-Apps auf Projektebene, Monitoring-Daten usw.). Dieser Vorgang kann möglicherweise 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 von Assets ist der Tab „Assets“ im Code-Editor. Dort können Sie Ihre Earth Engine-Assets ansehen und manuell löschen.

So löschen Sie programmatisch ein Asset 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 die Sicherheitssandbox des Code-Editors verhindert, dass dieser Aufruf in dieser Umgebung funktioniert.

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

Befehlszeilentool

Verwenden Sie den Befehl rm:

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 „Skripts“ ein Skript oder ein 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 ihre Skripts mit Git verwalten. Unter https://earthengine.googlesource.com/ finden Sie eine Liste der Repositorys, die Sie ansehen können.

Earth Engine-Apps

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

Verwenden Sie die Seite Links verwalten, um Ihre „Link abrufen“- Links aus dem Code-Editor anzuzeigen und zu 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 nicht kommerziellen (kostenlosen) Zugriff auf Earth Engine einrichten möchten, müssen Sie in der Cloud Console den Registrierungsfragebogen ausfüllen, um zu bestätigen, dass Ihr Projekt die Voraussetzungen erfüllt.

Bestätigung

Da Earth Engine kostenlosen Zugriff auf eine große Menge an Compute-Ressourcen gewährt, muss Google jedes Projekt bestätigen, das für den nicht kommerziellen Zugriff registriert ist. Die Bestätigung erfolgt im Rahmen der Registrierung. Wenn Sie den Bestätigungsfragebogen ausfüllen und Ihr Projekt als kommerziell eingestuft wird, können Sie Earth Engine nicht kostenlos verwenden.

Ab dem 26. September 2025 muss für alle nicht kommerziellen Projekte der Fragebogen in der Cloud Console ausgefüllt sein. Wir empfehlen, die Bestätigung so schnell wie möglich abzuschließen. Wenn Sie vor dem 26. September 2025 nichts unternehmen, wird der Zugriff Ihres Projekts auf Earth Engine pausiert, bis Sie die Bestätigung abgeschlossen haben.

Erneute Bestätigung

Für alle Projekte mit nicht kommerziellem Zugriff muss der Zugriff regelmäßig neu bestätigt werden.

Kommerziellen Zugriff konfigurieren

Wenn Sie für Ihr Projekt kommerziellen (kostenpflichtigen) Zugriff auf Earth Engine einrichten möchten, müssen Sie das Projekt auf der Registrierungsseite konfigurieren und ein Abo für das Rechnungskonto auswählen.

Kommerziellen Zugriff beenden

Wenn Sie direkter Earth Engine-Kunde sind und Earth Engine nicht mehr kostenpflichtig nutzen möchten, müssen Sie mehrere Änderungen vornehmen, um weitere Gebühren zu vermeiden:

  • Abo-Gebühren beenden

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

    • Sie können die Seite „Abos verwalten“ auch direkt für ein Rechnungskonto aufrufen:

      https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_ID

    • Wenn Sie das Abo „Limited“ auswählen, werden Ihrem Rechnungskonto nach dem aktuellen Abrechnungszeitraum keine weiteren Gebühren für das Earth Engine-Plattformabo in Rechnung gestellt.

  • Compute-Gebühren beenden

  • Speichergebühren beenden

    • Für gespeicherte Earth Engine-Assets fallen weiterhin Kosten an, auch wenn die API deaktiviert ist. Wenn Sie Ihre Assets löschen, werden keine weiteren Speichergebühren für Earth Engine in Rechnung gestellt.