Applications Earth Engine

Introduction

Les applications Earth Engine sont des interfaces utilisateur dynamiques et partageables pour les analyses Earth Engine. Avec les applications, les experts peuvent utiliser des éléments d'interface utilisateur simples pour exploiter le Data Catalog et la puissance d'analyse d'Earth Engine, que ce soit pour les experts ou les non-experts.

Les applications publiées depuis Earth Engine sont accessibles à partir de l'URL spécifique à l'application générée au moment de la publication. Aucun compte Earth Engine n'est requis pour afficher une application publiée ou interagir avec elle. Les applications sélectionnées comme étant mises en avant par leur créateur sont également disponibles dans une galerie d'applications spécifique à l'utilisateur (par exemple, USERNAME.users.earthengine.app).

Créer votre application

Les applications Earth Engine peuvent utiliser la plupart des fonctions de l'éditeur de code, à quelques exceptions près. De plus, nous avons conçu l'API interface utilisateur en pensant aux développeurs d'applications. Si vous ne connaissez pas l'API User Interface, consultez la présentation de l'API UI.

Publier votre application

Pour publier une application à partir de l'éditeur de code, chargez d'abord le script que vous souhaitez transformer en application, puis ouvrez le panneau de gestion des applications, auquel vous pouvez accéder en cliquant sur le bouton Applications au-dessus de la section du script dans l'éditeur de code.

Bouton "Gérer les applications"
Bouton "Gérer les applications"

Cliquez ensuite sur le bouton NEW APP (NOUVELLE APPLICATION).

Bouton "Nouvelle application"
Bouton Application

Dans la boîte de dialogue, choisissez l'accès Éditeur, un nom d'application, sélectionnez un projet Google Cloud et spécifiez l'emplacement du code source de l'application. Limitez l'accès à cette application à un groupe Google particulier ou rendez-la accessible au public à l'aide des options de l'onglet "Restriction". Pour les applications accessibles au public, vous pouvez également fournir une image d'aperçu personnalisée de l'application ainsi qu'une description dans l'onglet "Galerie". Cliquez sur "Mettre en avant cette application dans votre galerie d'applications" si vous souhaitez que cette application apparaisse dans votre galerie d'applications publique disponible à l'adresse USERNAME.users.earthengine.app. Vous pouvez également inclure un logo personnalisé dans l'angle supérieur gauche de l'application en important une image de votre choix depuis l'onglet "Logo".

Choisir l'accès Éditeur
Choisissez l'accès Éditeur : choisissez qui peut modifier l'application.
Publier une application, nom et URL
Publiez une application : choisissez un nom, un ID d'application et un projet cloud.
Publier une application, code source
Publier une application : sélectionnez le code source de l'application
Publier une application, détails de la publication
Publier une application : choisissez des options telles que la mise en avant de l'application dans votre galerie, les restrictions d'accès et le logo personnalisé

Gestion de vos applications

Pour gérer une application depuis l'éditeur de code, ouvrez le panneau de gestion des applications en cliquant sur le bouton Applications au-dessus de la section du script dans l'éditeur de code. Vous pouvez ensuite modifier la configuration de votre application ou la supprimer.

Gérer les applications
Gérer les applications

Collaborer avec d'autres utilisateurs sur des applications appartenant au projet

Par défaut, les applications que vous publiez sous votre nom d'utilisateur ne peuvent être modifiées que par vous. La collaboration sur les applications est possible avec les applications appartenant à un projet. Les applications appartenant à un projet sont des applications détenues et publiées dans un projet Cloud. Toute personne disposant du rôle IAM Éditeur d'applications Earth Engine peut modifier et supprimer les applications publiées dans le projet Cloud. En savoir plus sur les rôles IAM Earth Engine

Pour activer les applications appartenant à un projet, choisissez l'option Projet Cloud à l'étape "Choisir l'accès Éditeur", sélectionnez le projet Cloud que vous souhaitez utiliser, puis terminez le processus de publication de l'application comme d'habitude. L'application sera publiée sur le domaine PROJECT-ID.projects.earthengine.app et pourra être modifiée par toute personne disposant du rôle IAM "Éditeur d'applications Earth Engine" sur le projet cloud.

Publier une application appartenant à un projet
Publier une application appartenant à un projet

Pour afficher les applications d'un projet Cloud, appuyez sur le bouton AJOUTER UN PROJET CLOUD, puis sélectionnez le projet Cloud.

Ajouter un projet sur le cloud
Ajouter un projet Cloud

Pour partager le projet sur le cloud avec d'autres personnes, appuyez sur le bouton PARTAGER LE PROJET. Vous serez redirigé vers la page IAM de la console Cloud pour le projet, où vous pourrez accorder aux collaborateurs le rôle IAM "Éditeur d'applications Earth Engine".

Activer les applications appartenant au projet
Modifier et supprimer des applications appartenant au projet

Questions fréquentes

Comment supprimer une application de ma galerie d'applications ?
La case "Mettre en avant cette application" de la page de configuration de l'application détermine si une application apparaît ou non sur la page "Applications mises en avant". Les applications dont l'accès est limité ne peuvent pas être mises en avant.
Mon code Earth Engine est-il visible ?
Oui, à toute personne pouvant accéder à l'application. Bien qu'il ne soit pas clairement visible lorsque votre application est publiée, il est assez facile pour quelqu'un de consulter le code JavaScript de votre application en observant le trafic réseau vers son navigateur Web. Dans Chrome, par exemple, le code JavaScript est visible dans le panneau Réseau des outils pour les développeurs.
Quelles sont les causes possibles de l'erreur "Une erreur s'est produite lors du chargement de certaines parties de la carte" pour une application publiée ?
Assurez-vous que tous les éléments d'image ou de tableau utilisés dans votre application sont partagés publiquement ou avec l'application. Dans la boîte de dialogue de partage d'éléments, sélectionnez l'option "Tout le monde peut lire" ou choisissez le nom de l'application dans la liste déroulante. Pour les applications limitées à un groupe Google, le partage d'un élément avec ce groupe Google ne le rendra pas visible par l'application. Les éléments doivent plutôt être partagés avec l'application ou publiquement.
Pourquoi la page "L'application n'est pas encore prête" s'affiche-t-elle ?
Une fois l'application créée, la propagation des informations dans le système peut prendre un certain temps. Ce problème est généralement résolu en quelques minutes. Si l'erreur persiste, veuillez demander de l'aide.
Pourquoi les géométries que j'ai dessinées s'affichent-elles dans mon application ?
Cela permet d'afficher facilement des géométries de référence dans votre application et de créer des applications dans lesquelles les utilisateurs peuvent modifier les géométries. Si vous ne souhaitez pas que certaines géométries soient affichées ou modifiées, vous pouvez masquer ou verrouiller des calques de géométrie individuels pour empêcher les utilisateurs de les voir ou de les modifier avant de publier votre application. Pour en savoir plus, consultez la documentation sur les outils de géométrie.
Qu'est-ce que le quota d'applications ?
Pour éviter que des scripts erronés ou gourmands en ressources n'affectent la disponibilité du service, Earth Engine applique des quotas d'utilisation des applications pour les requêtes simultanées. Ce quota fonctionne de la même manière que le quota par utilisateur d'Earth Engine, sauf qu'il est lié à l'application plutôt qu'à un utilisateur spécifique.
Chaque application que je crée dispose-t-elle de son propre quota ?
Oui, un quota distinct est associé à chaque application. Pour les applications plus anciennes créées avec une clé API, le quota est lié au projet Cloud à partir duquel vous générez la clé API d'une application. Si vous générez plusieurs clés API à partir du même projet Cloud, elles partageront toutes le même quota d'utilisation.
Pourquoi un compte de facturation Cloud est-il requis ? Mes applications me seront-elles facturées ?
Nous utilisons Google Cloud Platform pour diverses tâches en arrière-plan. La création d'une application Earth Engine n'est pas facturée. Toutefois, Google Cloud Storage n'est pas sans frais. Par conséquent, si vous choisissez d'exporter les résultats de vos analyses vers Google Cloud Storage, des frais peuvent s'appliquer.
Comment mieux comprendre l'utilisation et le quota de mes applications ?

Si le quota est dépassé, Earth Engine peut renvoyer des erreurs HTTP 429: Too Many Requests. En général, ces erreurs sont gérées par la bibliothèque cliente Earth Engine, qui encapsule les requêtes dans un intervalle exponentiel entre les tentatives, en réessayant la requête jusqu'à ce qu'elle aboutisse. La bibliothèque cliente Earth Engine relancera la requête cinq fois.

Si votre application devient si populaire que de nombreux utilisateurs reçoivent des erreurs de dépassement de quota, un message d'avertissement s'affiche et Earth Engine peut être amené à restreindre (temporairement) l'accès à l'application.

Pour éviter de recevoir des erreurs 429, vous pouvez activer la mise en cache pour votre application, par exemple en stockant les statistiques agrégées pouvant être mises en cache en tant qu'éléments de table Earth Engine, plutôt qu'en les calculant à la volée.