Global

Os mapas do tempo desde a última ocorrência da superfície de água apresentam o número de anos transcorridos desde a última vez em que cada pixel foi identificado como superfície de água, considerando 2025 como ano de referência.

O produto permite identificar áreas com ocorrência recente de água e áreas onde a última ocorrência foi registrada há mais tempo.

O mapa de ‘Tempo desde a última ocorrência da superfície de água’ apresenta o número de anos transcorridos desde o último mapeamento da superfície de água em relação a um ano para um determinado pixel. Assim, as classes do mapa da Coleção 5 podem variar de 0 a 40 (anos), considerando a série de dados de 1985 a 2025.

 Exemplos de interpretação dos valores de pixel do mapa de ‘Tempo desde a última ocorrência de superfície de água’:

Valor de pixel Classe Interpretação Cor
(hexadecimal)
0 0 anos Área mapeada com superfície de água no ano de referência. Isto é, para o mapa de 2025, a área foi identificada como superfície de água em 2025. #FFFF80
1 1 ano Área mapeada com superfície de água há um ano. Isto é, para o mapa de 2025, a área foi identificada como superfície de água pela última vez em 2024. #FFFB7D
2 2 anos Área mapeada com superfície de água há dois anos. Isto é, para o mapa de 2025, a área foi identificada como superfície de água pela última vez em 2023. #FFF678
35 35 anos Área mapeada com superfície de água há trinta e cinco anos. Isto é, para o mapa de 2025, a área foi identificada como superfície de água pela última vez em 1990. #8A2E0A
40 40 anos Área mapeada com superfície de água há quarenta anos. Isto é, para o mapa de 2025, a área foi identificada como superfície de água pela última vez em 1985. #6B0601
Arquivos para classificação da legenda dos mapas de 'Tempo desde a última ocorrência de superfície de água' em programas como QGIS ou R/Python serão disponibilizados em breve :)

Os mapas de  ‘Tempo desde a última ocorrência da superfície de água’ foram gerados a partir da identificação do ano mais recente em que houve mapeamento de superfície de água na série histórica de 1985 a 2025.

Em seguida, foi calculado o número de anos transcorridos entre essa última ocorrência e o ano de referência, 2025. Assim, o valor 0 (zero) representa pixels mapeados como água em 2025, enquanto valores crescentes indicam há quantos anos ocorreu o último registro de superfície de água naquele pixel. Quanto maior o valor, mais antiga é a última ocorrência de água registrada.

Mais informações sobre o produto podem ser exploradas no documento descritivo do método – ATBD.

Os documentos descritivos do método são denominados ATBD - sigla em inglês para Algorithm Theoretical Basis Document (Documento de Base Teórica do Algoritmo ) - e descrevem todo o processo de desenvolvimento e produção dos mapas e algoritmos utilizados em cada uma das coleções de mapas e dados do respectivo produto. O ATBD da Coleção 5 do MapBiomas Água será disponibilizado em breve.

É possível acessar os mapas de ‘Tempo desde a última ocorrência de superfície de água’ da Coleção 5 do MapBiomas Água de diferentes formas. Explore as opções listadas abaixo:

____________________________________________________________________________

  • Como baixar dados?
    1. Acesse: https://plataforma.brasil.mapbiomas.org/
    2. Clique na seção ‘Downloads’
    3. Selecione o dado e o ano de interesse
    4. Baixe o mapa em ‘Suas análises’
    5. Baixe as estatísticas a partir da interação com os gráficos
A funcionalidade 'Download' de mapas está temporariamente suspensa na plataforma MapBiomas. Estamos trabalhando para reestabelece-la o mais breve possível. Enquanto isso, explore as opções de acesso e download dos mapas de 'Tempo desde a última ocorrência de superfície de água' via Google Earth Engine.

Os mapas de Tempo desde a última ocorrência de superfície de água são gerados diretamente na Plataforma MapBiomas a partir da análise da série de mapas anuais de superfície de água da Coleção 5 do MapBiomas – análises on-the-fly.

Isto significa que não há um conjunto de dados – asset – de Tempo desde a última ocorrência de superfície de água no GEE. De todo modo, é possível produzir os mapas de ‘Tempo desde a última ocorrência de superfície de água’ no Google Earth Engine a partir do conjunto de dados – asset –  de superfície de água anual, disponível para acesso público via ID/path:

  • projects/mapbiomas-public/assets/brazil/water/collection5/mapbiomas_brazil_collection5_water_annual_v4

 

Desenvolvemos este exemplo de código para a geração de visualizações e exportações (Download) de mapas de ‘tempo desde a última ocorrência de superfície de água’ no Google Earth Engine (GEE). Abaixo explicamos as etapas principais da análise:

  • 1) Acesso aos mapas anuais de superfície de água da Coleção 5 do MapBiomas Água:
    • Os mapas de ‘Tempo desde a última ocorrência da superfície de água’ foram gerados a partir dos dados anuais de superfície de água. Assim, no GEE , analisamos todos os mapas anuais da série de 1985 a 2025 a fim de identificar a ocorrência de água (id: 1 ) em cada pixel ao longo da série.
  • 2) Identificação do último ano de ocorrência de superfície de água:
    • Via procedimentos de álgebra de mapas, codificamos os pixels identificados como superfície de água de acordo com seu ano de mapeamento e selecionamos o valor máximo – isto é, o maior ano, logo o último de ocorrência da classe.
Exemplo de função para identificar o último ano de ocorrência de superfície de água
// DADOS PARA A ANÁLISE:
var assetIdWaterSurface = 'projects/mapbiomas-public/assets/brazil/water/collection5/mapbiomas_brazil_collection5_water_annual_v4';
var targetClass = 1; // Classe que representa superfície de água.
var startYear = 1985; // 1º ano da série temporal
var endYear = 2025; // último ano da série
var years = ee.List.sequence(startYear, endYear, 1);  // Gera os anos da série (1985 - 2025)
var bandPrefix = 'classification_';  // Prefixo das bandas. Exemplo: classification_1985 | Cada banda representa a classificação de um ano da série

// FUNÇÃO: ÚLTIMO ANO DE OCORRÊNCIA
/* Esta função responde: "Qual foi o último ano em que cada pixel foi classificado como a classe de interesse?" 
   Exemplo:
   1985 → água
   ...
   2020 → água
   2021 → não água
  ...
  2025 → não água
  Resultado: pixel = 2020
*/
var getClassLastYear = function(assetID, targetClass, years, bandPrefix) {
    var image = ee.Image(assetID); // Carrega a imagem multibanda.
    
    var imageYears = years.map(  // Para cada ano, cria uma imagem contendo:  ano → se o pixel pertence à classe alvo;  0   → caso contrário
        function(year) {
            year = ee.Number(year);
            var bandName = ee.String(bandPrefix).cat(year.format('%.0f'));

            var imageYear =
                image
                .select(bandName) // Seleciona cada banda (classificação anual)

                .eq(targetClass) // Verifica se o pixel pertence à classe alvo.

                .multiply(year) // Se pertence à classe, guarda o ano. Caso contrário, o valor será 0.

                .rename('year');

            return imageYear;
        }
    );
    var imageCollection = ee.ImageCollection.fromImages(imageYears);

    var lastYear = imageCollection.max().selfMask();  // Obtém o maior ano para cada pixel. O maior ano corresponde à última ocorrência da classe.
    return lastYear;
};
  • 3) Cálculo do tempo desde a última ocorrência de superfície de água:
    • Após a identificação do ano de última ocorrência, consideramos o ano de 2025 como referência e calculamos o tempo decorrido – em anos – desde a última vez que o pixel foi mapeado como superfície de água.
Exemplo de função para cálculo de tempo desde a última ocorrência
// ============================================================
// FUNÇÃO: TEMPO DESDE A ÚLTIMA OCORRÊNCIA
// ============================================================
// Calcula: ano final da série - último ano de ocorrência
// Exemplo:
//
// último ano de água = 2018
// ano final da série = 2025
//
// 2025 - 2018 = 7 anos
//
// Portanto: pixel = 7
// ============================================================
var timeSinceLastYear = function(lastYear, finalYear){
    var timeSinceImage =
        ee.Image
        .constant(finalYear)
        .subtract(lastYear)
        .selfMask();
    return timeSinceImage;
};

O repositório público do MapBiomas no GitHub oferece exemplos de código e orientações sobre como reproduzir análises de última ocorrência da classes ao longo da série temporal de dados.