Earth Engine permet d'accéder aux widgets d'interface utilisateur (UI) côté client via le package ui. Utilisez le package ui pour créer des interfaces graphiques pour vos scripts Earth Engine. Ces interfaces peuvent inclure des widgets de saisie simples tels que des boutons et des cases à cocher, des widgets plus complexes tels que des graphiques et des cartes, des panneaux pour contrôler la mise en page de l'UI et des gestionnaires d'événements pour les interactions entre les widgets d'UI. Découvrez toutes les fonctionnalités de l'API ui dans l'onglet Documentation situé sur la gauche de l'éditeur de code. L'exemple suivant utilise le package ui pour illustrer les fonctions de base permettant de créer un widget, de définir le comportement lorsque l'utilisateur clique sur le widget et d'afficher le widget.
Bonjour !
Cet exemple représente une UI simple d'un bouton affiché dans la console. Si vous cliquez sur le bouton, le message "Hello, world!" s'affiche dans la console:
// Make a button widget. var button = ui.Button('Click me!'); // Set a callback function to run when the // button is clicked. button.onClick(function() { print('Hello, world!'); }); // Display the button in the console. print(button);
Notez que le bouton est d'abord créé avec un seul argument: son libellé. Ensuite, la fonction onClick() du bouton est appelée. L'argument de onClick() est une autre fonction qui s'exécute chaque fois que l'utilisateur clique sur le bouton. Ce mécanisme d'une fonction à appeler (une fonction de "rappel") lorsqu'un événement se produit est appelé "gestionnaire d'événements" et est largement utilisé dans la bibliothèque d'UI. Dans cet exemple, lorsque l'utilisateur clique sur le bouton, la fonction affiche "Hello, world!" dans la console.
Mutabilité
Notez que contrairement aux objets de l'espace de noms ee.*, les objets de l'espace de noms ui.* sont modifiables. Vous n'avez donc pas besoin de réattribuer l'objet à une variable chaque fois que vous appelez une fonction d'instance sur l'objet. Il suffit d'appeler la fonction pour modifier le widget. Si vous ajoutez le code suivant à l'exemple précédent, un autre rappel sera enregistré pour l'événement de clic du bouton:
// Set another callback function on the button. button.onClick(function() { print('Oh, yeah!'); });
Copiez ce code à la fin de l'exemple précédent, puis cliquez sur Run (Exécuter). Lorsque vous cliquez sur le bouton, les deux messages sont imprimés dans la console.
Consultez les pages sur l'UI pour en savoir plus sur la création d'UI pour vos scripts Earth Engine. La page des widgets propose une visite guidée visuelle et décrit les fonctionnalités de base des widgets du package ui. La page Panneaux et mises en page décrit les conteneurs et les mises en page de niveau supérieur que vous pouvez utiliser pour organiser et disposer les widgets. La page Événements contient des informations sur la configuration du comportement et de l'interaction des widgets dans votre UI.