Agora que você já pode começar a escrever JavaScript do Earth Engine, copie o código a seguir no Editor de código:
Editor de código (JavaScript)
// Instantiate an image with the Image constructor. var image = ee.Image('CGIAR/SRTM90_V4'); // Zoom to a location. Map.setCenter(-112.8598, 36.2841, 9); // Center on the Grand Canyon. // Display the image on the map. Map.addLayer(image);
Clique no botão Executar na parte de cima do editor de código e observe que uma imagem muito cinza aparece no mapa. Não se preocupe, você vai melhorar isso em breve. Se você não conhece a sintaxe de alguma parte deste exemplo, consulte o tutorial de JavaScript para o Earth Engine.
Image Constructor
A primeira novidade neste exemplo é o construtor de imagens
ee.Image(). O argumento fornecido ao construtor é o ID de string de uma imagem no catálogo de dados do Earth Engine. Consulte a guia Docs, à esquerda do editor de código, para ver uma lista completa de argumentos possíveis para o construtor de imagens. A guia Documentos representa as informações mais atualizadas sobre o que o Earth Engine pode fazer.
Para descobrir um ID de imagem, pesquise no catálogo de dados do Earth Engine usando a ferramenta de pesquisa na parte de cima do Editor de código. Por exemplo, digite "elevação" no campo de pesquisa e observe que uma lista de rasteres é retornada. Clique na entrada "SRTM Digital Elevation Data Version 4" para ver mais informações sobre esse conjunto de dados. À direita da descrição do conjunto de dados, há um campo ID da imagem. O ID da imagem no exemplo é copiado da descrição do conjunto de dados.
Uma alternativa para copiar e colar IDs de imagens é usar o botão Importar na descrição do conjunto de dados ou o link importar no lado direito dos resultados da pesquisa. Se você clicar no link ou botão de importação, uma variável será criada automaticamente em uma seção especial, chamada "Importações", na parte de cima do script. Para renomear a variável, clique no nome dela na seção de importações.
Configurar o mapa
A segunda parte nova deste exemplo é a chamada Map.setCenter(). Esse método no objeto Map, que representa a exibição do mapa no editor de código, centraliza o mapa na longitude e latitude (em graus decimais) e no nível de zoom especificados, em que 1 é o zoom mínimo para que o mapa mostre toda a superfície da Terra. Números maiores aumentam a partir daí. Descubra todos os métodos no objeto Map verificando a seção "Mapa" na guia "Documentos" à esquerda do editor de código.
Adicionar uma camada ao mapa
A última linha do exemplo diz: use o método addLayer() do objeto Map para adicionar uma imagem à exibição do mapa no Editor de código.
Parabéns! Você criou seu primeiro script do Earth Engine. Na próxima seção, você vai aprender a melhorar a aparência dessa imagem.
Digressão: imagens no Earth Engine
As imagens no Earth Engine (consulte esta página para mais detalhes) são compostas por uma ou mais bandas. Cada banda em uma imagem tem um nome, valores de pixel, resolução de pixel e projeção próprios. Como você vai descobrir em breve, a imagem do SRTM tem uma banda: "elevation".
Quando você adiciona uma imagem a um mapa usando Map.addLayer(), o Earth Engine precisa determinar como mapear os valores nas bandas de imagem para cores na tela. Se uma imagem de banda única for adicionada a um mapa, por padrão, o Earth Engine vai mostrar a banda em escala de cinza, em que o valor mínimo é atribuído ao preto e o valor máximo é atribuído ao branco.
Se você não especificar o mínimo e o máximo, o Earth Engine vai usar valores padrão. Por exemplo, a imagem que você acabou de adicionar ao mapa é mostrada como uma imagem em escala de cinza esticada para o intervalo completo dos dados ou um inteiro de 16 bits [-32768, 32767]. As bandas float são esticadas para [0, 1] e as bandas byte são esticadas para [0, 255] por padrão.
Para descobrir o tipo de dados da imagem, imprima e inspecione o objeto de imagem na guia Console. Por exemplo, cole o seguinte após o código anterior:
Editor de código (JavaScript)
print('SRTM image', image);
Quando você clicar em "Executar", observe que um objeto vai aparecer no console. Para investigar as propriedades do objeto, clique no zippy (
) à esquerda do objeto ou da propriedade. Expanda o objeto de imagem, a propriedade "bands", a banda "elevation" no índice "0" e a propriedade "data_type" da banda "elevation" para descobrir que é um tipo de dados signed int16.
Personalizar a visualização de camadas
Para mudar a forma como os dados são esticados, forneça outro parâmetro à chamada Map.addLayer(). Especificamente, o segundo parâmetro, visParams, permite especificar os valores mínimo e máximo a serem mostrados. Para descobrir quais valores usar, ative a guia Inspetor e clique no mapa para ter uma ideia do intervalo de valores de pixel. Outra opção é usar o Gerenciador de camadas para esticar os dados de forma interativa e observar os valores mínimos e máximos correspondentes aos intervalos de percentis ou desvio padrão. Suponha que, por meio dessa experimentação, você determine que os dados precisam ser esticados para [0, 3000]. Para mostrar a imagem usando esse intervalo, use:
Editor de código (JavaScript)
Map.addLayer(image, {min: 0, max: 3000}, 'custom visualization');
O parâmetro visParams é um objeto com propriedades que especificam o min e o max. Saiba mais sobre objetos JavaScript no tutorial de JavaScript ou nesta referência externa. O terceiro parâmetro de Map.addLayer() é o nome da camada exibida no Gerenciador de camadas. O resultado será semelhante à Figura 1. Passe o cursor sobre a caixa Camadas à direita para ver o efeito da mudança de nome.
Para mostrar uma única banda usando uma paleta de cores, adicione uma propriedade palette ao objeto visParams:
Editor de código (JavaScript)
Map.addLayer(image, {min: 0, max: 3000, palette: ['blue', 'green', 'red']}, 'custom palette');
O resultado será parecido com a Figura 2.
Digressão: paletas
Com as paletas, é possível definir o esquema de cores para imagens de banda única. Uma paleta é uma lista de strings de cores delimitada por vírgulas que são interpoladas linearmente entre os valores máximo e mínimo nos parâmetros de visualização (ou padrões de acordo com o tipo de intervalo, conforme descrito anteriormente). Por exemplo, pixels menores ou iguais ao mínimo serão mostrados com a primeira cor da lista, e pixels maiores ou iguais ao máximo serão mostrados com a última cor da lista. As cores intermediárias são esticadas linearmente para valores de pixels intermediários.
As cores são definidas usando o esquema de valores de cores CSS padrão da Web. Consulte esta referência externa para saber mais. As cores podem ser especificadas por nome ou como strings hexadecimais que indicam a combinação de vermelho, verde e azul. O menor valor em qualquer uma das três posições é 00 (que representa o número decimal 0), enquanto o maior é FF (que representa o número decimal 255). A string "000000" representa a cor preta, "FFFFFF" é branco, "FF0000" é vermelho, "00FF00" é verde e "0000FF" é azul. Consulte a seção "Paletas de cores" para mais detalhes. Outros trechos são possíveis usando descritores de camada estilizada, conforme descrito nesta seção.
Mais adiante neste tutorial, você vai aprender a mostrar imagens multibanda. Mas primeiro, acesse a próxima página para saber como realizar cálculos com imagens.