Earth Engine s'exécute sur Google Cloud et nécessite des projets Cloud pour l'accès et la gestion 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 le contrôle des accès, la gestion des ressources et la surveillance de l'utilisation dans la console Cloud.
Accéder à Earth Engine
Pour utiliser Earth Engine, vous devez avoir accès à un projet Cloud qui :
- l'API Earth Engine est activée ;
- est enregistré pour un usage commercial ou non commercial ;
- vous accorde (ou accorde à l'utilisateur) les rôles et autorisations appropriés.
Créer un projet
Accédez à la page d'inscription pour créer et enregistrer un projet Cloud ou enregistrer un projet existant.
Les projets créés lors de l'inscription 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 la console Cloud.
Étapes manuelles (automatisées par la page d'inscription)
Créer un projet Cloud
Si vous ne l'avez pas déjà fait, créez un projet Google Cloud. Pour ce faire, accédez à la page des projets de la console Cloud ou cliquez sur le bouton suivant :
Créer un projet CloudActiver l'API Earth Engine
Pour activer l'API Earth Engine pour votre projet, cliquez sur le bouton ci-dessous pour accéder à la page de l'API Earth Engine :
Activer l'API Earth EngineSur 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 de composants (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 commande
earthengine create folder avec un chemin d'accès, 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 composants 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 sur le projet.
Spécifier un projet
Les sections suivantes expliquent 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 commande gcloud. 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 de google.oath.service_account.Credentials.from_service_account_file() afin de s'authentifier avec un compte de service.
Configurer l'accès au projet
Les sections suivantes décrivent comment configurer les projets compatibles avec Earth Engine pour qu'ils puissent être 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 doivent également disposer des autorisations appropriées dans le projet. Vous pouvez configurer n'importe quel nombre de comptes de service d'un projet pour qu'ils utilisent 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 la console Cloud 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. Pour gérer les identifiants de votre projet Cloud, accédez au menu Cloud Console (), puis sélectionnez 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 pédagogique…
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…
Parfait ! Vous pouvez enregistrer un projet pour un usage commercial et y ajouter vos collaborateurs. Veuillez également tenir compte de la limite de sièges dans l'abonnement Earth Engine que vous sélectionnez.
Suppression des données Earth Engine
Suppression au niveau du compte
La suppression au niveau du compte supprimera 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, toutes les données Earth Engine associées sont effacées sous 30 jours environ.
Une fois les données supprimées, l'équipe Earth Engine ne peut pas les récupérer.
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, les assets stockés dans la racine du projet, les applications EE au niveau du projet, les données de surveillance, etc.). Cette opération peut être réversible pendant 30 jours, mais il n'est jamais possible de récupérer ces données au-delà de ce délai.
É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 supprimer un élément de manière programmatique à l'aide de son 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
Exécutez la commande rm :
earthengine rm projects/my-project/assets/my-assetScripts 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 https://earthengine.googlesource.com/ pour afficher la liste des dépôts que vous pouvez consulter.
Applications Earth Engine
Pour supprimer vos applications Earth Engine, utilisez le bouton "Applications" de l'éditeur de code pour les gérer.
Références à "Obtenir le lien"
Utilisez la page Gérer les liens pour afficher et supprimer vos liens "Obtenir le lien" depuis l'éditeur de code. Pour accéder à cette page, accédez à l'option "Gérer les liens" dans le menu déroulant à côté du bouton "Obtenir le lien".
Configurer l'accès non commercial
Pour configurer un accès non commercial (non payant) à Earth Engine pour votre projet, vous devez remplir le questionnaire d'enregistrement dans la console Cloud afin de confirmer l'éligibilité de votre projet.
Validation
Étant donné qu'Earth Engine accorde un accès non payant à 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 fait partie de l'inscription. Si vous répondez au 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 terminer la procédure de validation dès que possible. Si vous ne faites rien 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 avec accès non commercial devront être revalidés périodiquement.
Configurer l'accès commercial
Pour configurer un accès commercial (payant) à Earth Engine pour votre projet, vous devez configurer le projet à l'aide de la page d'inscription et choisir un forfait sur le compte de facturation.
Résiliation de l'accès commercial
Si vous êtes un client direct d'Earth Engine et que vous souhaitez arrêter de l'utiliser dans un contexte payant, vous devez effectuer 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" d'un compte de facturation :
https://code.earthengine.google.com/manage/plans?billing=YOUR_BILLING_ACCT_IDSi vous choisissez le forfait "Limité", votre compte de facturation ne sera plus facturé pour l'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 (EECU-temps), désactivez l'API Earth Engine dans 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 encourir des frais Earth Engine même si l'API est désactivée.
- Consultez l'aide de la console d'API pour savoir comment désactiver les API.
Mettre fin aux frais de stockage
- Les assets Earth Engine stockés continuent d'entraîner des coûts même si l'API est désactivée. Supprimer vos composants vous évite d'accumuler des frais de stockage supplémentaires dans EE.