API Earth Engine User Interface

O Earth Engine oferece acesso aos widgets da interface do usuário (IU) do lado do cliente pelo pacote ui. Use o pacote ui para criar interfaces gráficas para seus scripts do Earth Engine. Essas interfaces podem incluir widgets de entrada simples, como botões e caixas de seleção, widgets mais complexos, como gráficos e mapas, painéis para controlar o layout da interface e manipuladores de eventos para interações entre widgets da interface. Conheça todas as funcionalidades da API ui na guia Docs no lado esquerdo do editor de código. O exemplo a seguir usa o pacote ui para ilustrar funções básicas para criar um widget, definir o comportamento quando o usuário clica no widget e exibir o widget.

Hello, world!

Este exemplo representa uma interface simples de um botão exibido no console. Clicar no botão faz com que "Hello, world!" seja impresso no console:

Editor de código (JavaScript)

// 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);

Observe que, primeiro, o botão é criado com um único argumento: o rótulo. Em seguida, a função onClick() do botão é chamada. O argumento para onClick() é outra função que será executada sempre que o botão for clicado. Esse mecanismo de uma função a ser chamada (uma função de "callback") quando um evento acontece é chamado de "manipulador de eventos" e é usado amplamente na biblioteca de interface. Neste exemplo, quando o botão é clicado, a função imprime "Hello, world!" no console.

Mutabilidade

Ao contrário dos objetos no namespace ee.*, os objetos no namespace ui.* são mutáveis. Assim, não é necessário reatribuir o objeto a uma variável sempre que você chamar uma função de instância no objeto. Basta chamar a função para mudar o widget. Adicionar o código a seguir ao exemplo anterior resulta no registro de outro callback para o evento de clique do botão:

Editor de código (JavaScript)

// Set another callback function on the button.
button.onClick(function() {
  print('Oh, yeah!');
});

Copie esse código para o final do exemplo anterior e clique em Executar. Agora, quando você clica no botão, as duas mensagens são mostradas no console.

Use as páginas de interface para saber mais sobre como criar interfaces para seus scripts do Earth Engine. A página Widgets oferece um tour visual e descreve a funcionalidade básica dos widgets no pacote ui. A página Painéis e layouts descreve contêineres e layouts de nível superior que podem ser usados para organizar e organizar widgets. A página de eventos tem detalhes sobre como configurar o comportamento e a interação de widgets na interface.