Accès à Earth Engine

Earth Engine s'exécute sur Google Cloud et nécessite des projets Cloud pour la gestion des accès et des API. Tous les appels Earth Engine (qu'ils proviennent de l'éditeur de code, des bibliothèques clientes, des applications ou de l'API REST) sont acheminés via un projet Cloud, ce qui permet de contrôler les accès, de gérer les ressources et de surveiller l'utilisation dans Cloud Console.

Accéder à Earth Engine

Pour utiliser Earth Engine, vous devez avoir accès à un projet Cloud qui :

Créer un projet

Accédez à la page d'inscription pour créer et enregistrer un projet Cloud ou enregistrer un projet existant. Une fois l'enregistrement effectué, l'accès à Earth Engine est activé immédiatement.

Les projets créés lors de la procédure d'enregistrement peuvent être gérés dans la console Google Cloud. Vous pouvez activer ou désactiver l'API Earth Engine depuis la page de l'API Earth Engine dans Cloud Console.

Étapes manuelles (automatisées par la page d'inscription)

Créer un projet Cloud

Si ce n'est pas déjà fait, créez un projet Google Cloud. Vous pouvez le faire depuis la page des projets de Cloud Console ou en cliquant sur le bouton suivant :

Créer un projet Cloud

Activer l'API Earth Engine

Pour activer l'API Earth Engine pour votre projet, cliquez sur le bouton suivant pour accéder à la page de l'API Earth Engine :

Activer l'API Earth Engine

Sur la page de l'API Earth Engine, assurez-vous d'avoir sélectionné votre projet, puis cliquez sur le bouton ACTIVER.

Enregistrer le projet pour un usage commercial ou non commercial

Modifiez l'URL suivante pour votre projet, accédez à la page et suivez la procédure d'enregistrement. 

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

Créer un dossier d'éléments (facultatif)

Vous pouvez créer un dossier d'éléments Earth Engine associé à un projet Cloud auquel vous avez accès à l'aide de la earthengine create folder commande en utilisant un chemin comme décrit ici. Exemple : 

earthengine create folder projects/my-project/assets/

Vous pouvez également créer un dossier d'éléments pour un projet dans l'éditeur de code en ajoutant le projet dans le panneau "Éléments".

Vous n'avez pas besoin de créer ce dossier, sauf si vous prévoyez de stocker des éléments dans le projet.

Utiliser un projet existant

Renseignez-vous auprès du personnel informatique de votre organisation sur les projets Cloud existants configurés pour Earth Engine. Assurez-vous que le compte Google que vous utiliserez pour accéder aux services Earth Engine dispose des rôles et autorisations appropriés pour le projet.

Spécifier un projet

Les sections suivantes décrivent comment spécifier un projet pour les différentes interfaces des services Earth Engine.

Bibliothèques clientes (Python, JavaScript)

La fonction ee.Initialize() permet de spécifier un projet pour les requêtes Earth Engine provenant des bibliothèques clientes Python et JavaScript. Il existe plusieurs façons de configurer la spécification du projet. Pour en savoir plus, consultez la page Authentification et initialisation.

Éditeur de code

Cliquez sur l'icône de profil en haut à droite de l' éditeur de code, puis sélectionnez « Modifier le projet Cloud » dans le menu. Choisissez un projet dans la boîte de dialogue de sélection.

Applications Earth Engine

Lorsque vous publiez une application Earth Engine, vous êtes invité à sélectionner un projet pour acheminer les requêtes. Suivez les instructions de la boîte de dialogue de publication.

Outil de ligne de commande

Pour associer les appels Earth Engine de l'outil de ligne de commande à un projet Cloud, utilisez le paramètre --project dans votre appel à earthengine ou utilisez set_project pour définir un projet par défaut.

API REST

Pour associer des appels à l'API REST à un projet Cloud, émettez des appels HTTP authentifiés où l'authentification est gérée par oauth2. Dans un environnement local, vous pouvez utiliser la gcloud commande. Vous pouvez également utiliser un compte de service associé à un projet Cloud. Consultez le guide de démarrage rapide de l'API REST pour obtenir un exemple d'utilisation google.oath.service_account.Credentials.from_service_account_file() pour vous authentifier avec un compte de service.

Configurer l'accès au projet

Les sections suivantes décrivent comment configurer des projets compatibles avec Earth Engine pour qu'ils soient utilisés par d'autres personnes et comptes de service.

Comptes de service

Les comptes de service ont automatiquement accès une fois que leur projet parent est enregistré et que l'API Earth Engine est activée. Ils ont également besoin des autorisations appropriées dans le projet. Vous pouvez configurer n'importe quel nombre de comptes de service sur un projet pour utiliser Earth Engine. Consultez la page Comptes de service pour en savoir plus sur l'utilisation des comptes de service avec Earth Engine.

Comptes Google

Les projets Cloud utilisent Cloud IAM pour gérer les rôles et les autorisations. Pour que d'autres personnes puissent accéder à Earth Engine via votre projet, vous devez utiliser Cloud Console pour leur accorder les rôles et autorisations appropriés.

ID client OAuth 2.0

Vous devrez peut-être créer un ID client OAuth 2.0 à partir d'un projet, par exemple pour créer une application qui transmet les identifiants utilisateur à Earth Engine. Vous pouvez gérer les identifiants de votre projet Cloud en accédant au menu Cloud Console (), puis en sélectionnant API et services > Identifiants. (Choisissez le projet si vous y êtes invité).

Pour créer un ID client pour le projet, cliquez sur + CRÉER DES IDENTIFIANTS > ID client OAuth > Application Web.

Dans la configuration de l'application Web :

  • Spécifiez les origines JavaScript autorisées, par exemple :
http://localhost:8080
https://foo-ee-project.appspot.com
  • Spécifiez les URI de redirection autorisés, par exemple :
http://localhost:8080/oauth2callback
https://foo-ee-project.appspot.com/oauth2callback

En savoir plus sur l'authentification des utilisateurs avec OAuth.

Scénarios courants

Je donne un cours...

Parfait ! Si vous enregistrez un projet non commercial, aucune configuration de facturation n'est requise. Vous pouvez ensuite ajouter vos élèves au projet.

Je fais partie d'une équipe opérationnelle/d'une organisation commerciale organization...

Parfait ! Vous pouvez enregistrer un projet pour un usage commercial et y ajouter vos collaborateurs. Veuillez également prêter attention à la limite de postes dans le abonnement Earth Engine que vous sélectionnez.

Suppression des données Earth Engine

Suppression au niveau du compte

La suppression au niveau du compte supprime toutes les données Earth Engine de votre compte.

Si votre compte fait partie d'une organisation Google Workspace, votre administrateur contrôle les données de votre compte. Lorsqu'un administrateur supprime un compte Google Account, toutes les données Earth Engine associées sont effacées dans un délai d'environ 30 jours.

L'équipe Earth Engine ne peut pas récupérer les données une fois qu'elles ont été supprimées.

Projets Cloud

Lorsqu'un projet Cloud est supprimé, cela déclenche la suppression des données Earth Engine associées à ce projet (y compris, par exemple, tous les éléments stockés dans la racine du projet, toutes les applications EE au niveau du projet, les données de surveillance, etc.). Ce processus peut être réversible pendant 30 jours, mais il n'est jamais possible de récupérer ces données après 30 jours.

Éléments

La méthode la plus simple pour supprimer vos éléments consiste à utiliser l'onglet "Éléments" de l'éditeur de code pour afficher et supprimer manuellement vos éléments Earth Engine.

Pour la suppression programmatique d'un élément avec l'ID projects/{project-id}/assets/{asset-id} (par exemple, projects/my-project/assets/my-asset) :

Client Python

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

Client JavaScript

Notez que le bac à sable de sécurité de l'éditeur de code empêche cet appel de fonctionner dans cet environnement.

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

Outil de ligne de commande

Utilisez la commande rm :

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

Scripts de l'éditeur de code

Pour supprimer vos scripts de l'éditeur de code Earth Engine :

Éditeur de code

Dans l'onglet "Scripts" de l'éditeur de code, sélectionnez un script ou un dépôt, puis supprimez-le. Une fois qu'un dépôt a été marqué comme supprimé, il devient irrécupérable au bout de 30 jours.

Utiliser Git

Les utilisateurs avancés peuvent utiliser Git pour gérer leurs scripts. Consultez la page https://earthengine.googlesource.com/ pour obtenir la liste des dépôts que vous pouvez afficher.

Applications Earth Engine

Pour supprimer vos applications Earth Engine, utilisez le "Applications" bouton de l'éditeur de code pour les gérer.

Utilisez la page Gérer les liens pour afficher et supprimer vos liens "Obtenir le lien" de l'éditeur de code. Pour accéder à cette page, accédez à l'option "Gérer les liens" dans le menu déroulant situé à côté du "Obtenir le lien" bouton.

Configurer l'accès non commercial

Pour configurer un accès Earth Engine non commercial (sans frais) pour votre projet, vous devez remplir le questionnaire d'inscription dans Cloud Console afin de confirmer l'éligibilité de votre projet.

Validation

Étant donné qu'Earth Engine accorde un accès sans frais à une grande quantité de ressources de calcul, Google exige la validation de chaque projet enregistré pour un accès non commercial. La procédure de validation est effectuée dans le cadre de l'enregistrement. Si vous remplissez le questionnaire de validation et que votre projet est considéré comme commercial, vous ne pourrez pas utiliser Earth Engine sans payer.

À partir du 26 septembre 2025, tous les projets non commerciaux devront avoir rempli le questionnaire dans la console Cloud. Nous vous recommandons de suivre la procédure de validation dès que possible. Si vous ne prenez aucune mesure avant le 26 septembre 2025, l'accès de votre projet à Earth Engine sera suspendu jusqu'à ce que vous terminiez la procédure de validation.

Nouvelle validation

Tous les projets disposant d'un accès non commercial devront être validés de nouveau régulièrement.

Configurer l'accès commercial

Pour configurer un accès Earth Engine commercial (payant) pour votre projet, vous devez configurer le projet à l'aide de la page d'inscription et choisir un forfait sur le compte de facturation.

Mettre fin à l'accès commercial

Si vous êtes un client direct d'Earth Engine et que vous souhaitez cesser d'utiliser Earth Engine dans un contexte payant, vous devez apporter plusieurs modifications pour ne plus être facturé :

  • Arrêter les frais d'abonnement

    • Pour résilier l'abonnement Earth Engine sur votre compte de facturation, vous devez utiliser la page "Gérer les forfaits" (accessible depuis le menu déroulant des paramètres utilisateur en haut à droite de l'éditeur de code lorsque vous utilisez un projet Cloud enregistré associé à ce compte de facturation).

    • Vous pouvez également accéder directement à la page "Gérer les forfaits" pour un compte de facturation :

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

    • Si vous choisissez le forfait "Limité", votre compte de facturation ne sera plus facturé pour les frais d'abonnement à la plate-forme Earth Engine après votre cycle de facturation en cours.

  • Arrêter les frais de calcul

    • Pour éviter de nouveaux frais liés au calcul (temps d'EECU), désactivez l'API Earth Engine sur vos projets Cloud. Notez que cela ne met pas fin aux requêtes en cours ni ne supprime les objets stockés. Vous pouvez donc toujours être facturé pour Earth Engine même si l'API est désactivée.
    • Consultez l'aide de la console API pour savoir comment désactiver les API.

  • Arrêter les frais de stockage

    • Les éléments Earth Engine stockés continuent de générer des coûts même si l'API est désactivée. Si vous supprimez vos éléments, vous ne serez plus facturé pour le stockage EE.