A API da plataforma está em constante melhoria para fornecer novos dados e melhor entendimento de seus campos e relações dos dados. Aqui você encontrará todas as mudanças que estão ocorrendo na API e que são importantes para você acompanhar e atualizar como você realizar suas consultas.

• query alerts e downloadShapefile mudança no filtro de embargo:
  • argument isInEmbargoedArea marcado como depreciado e substituído por isInEmbargoedRuralProperty e isInEmbargoedAlerta .

• query alerts e downloadShapefile refinamento do filtro de embargo:
  • argument isInEmbargoedAlerta adicionado para filtrar alertas com embargo do MapBiomas Alerta;
  • argument isInEmbargoedRuralProperty adicionado para filtrar alertas com embargo de imóvel rural (SICAR).
• type DeforestationTypes classes de desmatamento agora carregadas dinamicamente a partir do banco de dados, refletindo as classes disponíveis por iniciativa;
• type Territory field category adicionado para identificar a categoria do território retornado;
• query territoryOptions atualizada para incluir a categoria bolsa_verde_program (Programa Bolsa Verde) e normalizar categorias (refined_biome → biome , city → municipality ).

• query platformFeatureFlags nova query para retornar as feature flags da plataforma organizadas por categoria (header, filter, alert_list, report, downloads, etc.);
• query relatoryAttributes nova query para retornar os metadados e colunas disponíveis nos relatórios exportáveis (csv, shapefile);
• type AlertData mudanças na legenda e cruzamentos:
  • field classesLabels marcado como depreciado e substituído por legendLclu ;
  • field legendLclu adicionado com a legenda do Uso e Cobertura do MapBiomas incluindo cores e rótulos;
  • field crossingTerritories adicionado para retornar cruzamentos com territórios de forma dinâmica;
  • field alertIntersections adicionado para retornar cruzamentos configuráveis por iniciativa.
• type PointHistoryCoverage (via query pointInformation):
  • field labels aprimorado com legenda das classes de cobertura histórica do ponto.

• query downloadShapefile nova query para solicitar o download assíncrono de shapefile de alertas filtrados, com os mesmos parâmetros de filtro da query alerts.

• type SourceTypes adicionada a fonte ProdesCaatinga (PRODES-CAATINGA).

• query territoryOptions adaptada para as iniciativas da Bolívia (região → bioma, departamento → estado, município → cidade) e Colômbia;
• query ruralProperty field geomRuralProperty adicionado para retornar a geometria do imóvel rural em formato WKT.

• query findLastUpdateRelatory nova query para retornar a data da última atualização dos arquivos de download (csv de alertas, csv de alertas/imóveis e shapefile).

• type AlertData e type RuralPropertyData field imageContext adicionado com URLs das imagens do alerta/imóvel rural via API de imagens.

• query findSuspendedJudicialAlert nova query para retornar alertas com status suspended-under-judicial-order a partir do código do imóvel rural;
• type DeforestationTypes adicionada a opção OilPalm (Dendezeiro) para filtrar alertas com vetor de pressão de dendezeiro.

• type SourceTypes adicionada a fonte ProdesPantanal (PRODES-PANTANAL).

• query territoryOptions adaptada para a iniciativa do Peru com categorias específicas (país, região amazônica → bioma).

• type SourceTypes adicionada a fonte DeterPantanal (DETER-PANTANAL).

• type AlertData field id marcado como depreciado.

• type AlertData mudanças para a melhor compreensão dos cruzamentos e embargos:
  • field embargoedAreasIds marcado como depreciado e substituído por crossedEmbargoesIds ;
  • fields crossedEmbargoesIds , crossedEmbargoesList , crossedEmbargoesArea e crossedEmbargoesTotal adicionados;
  • arguments carCode e carId marcados como depreciados e substituídos por ruralPropertyCode em diversos fields do alerta;
  • field imageAcquiredBeboreList marcado como depreciado e substituído por imageAcquiredBeforeList .
• type RuralPropertyData ampliado com fields alerts , propertyType , stateAcronym , boundingBox e demais dados do imóvel rural para consultas de laudo.

• query territoryOptions adaptada para suportar a iniciativa da Indonésia, com categorias de território específicas (ilha → bioma, província → estado);
• query pointInformation e demais consultas geoespaciais passam a utilizar o SRID configurável por iniciativa (APP_SRID ).

• query pointInformation modificada para a inclusão da cobertura histórica do ponto e remoção da requisição REST da plataforma:
  • field historyCoverage adicionado para retornar as classes de uso e cobertura do MapBiomas do ponto consultado. Leia mais sobre histórico do ponto ou consulte a query pointInformation .
• query alerts mudança para a melhor compreensão dos cruzamentos com imóveis:
  • field carCodes marcado como depreciado e substituído por propertyCodes ;
• query alert mudanças para a melhor compreensão dos cruzamentos com imóveis:
  • field carCode marcado como depreciado e substituídos por propertyCode .
  • field carId marcado como depreciado, em futuras versões apenas será possível pesquisar pelo código do imóvel rural não sendo possível utilizar o identificar interno da plataforma.
• query alert_exporter mudança para a melhor compreensão dos cruzamentos com imóveis:
  • field carCodes marcado como depreciado e substituído por propertyCodes ;
• query alert_summary
  • carCodes marcado como depreciado e substituído por propertyCodes ;

• query alertStatusByBiomes nova query para retornar o status de publicação dos alertas em relação aos biomas; Leia mais sobre em andamento da publicação dos alertas ou consulte a query alertStatusByBiomes

• Type AlertGeometry mudança para a melhor compreensão das urls retornadas:
  • field changes marcado como depreciado e substituído por changes_usage_and_coverage_landsat .

• query ruralProperty mudança para a melhor compreensão dos cruzamentos com imóveis:
  • field car_code marcado como depreciado e substituído por property_code .
• query lastAlertPublication adição de informação:
  • field publicationRange inserido para exibir a data da última publicação e a data máxima de publicação dos alertas. Visto que os alertas publicados no dia x poderão ter data de publicação do alerta no mesmo dia ou em dias anteriores.
• Type RuralPropertySummary mudança para a melhor compreensão dos cruzamentos com imóveis:
  • Field state e car_type marcados como depreciados e substituídos por state_acronym e property_type respectivamente.

• query territoryOptions a partir deste momento tem as unidades de conservação municipais, estaduais e federais categorizadas por área de proteção integral e uso sustentável. Anteriormente, as unidades de conservação não estavam categorizadas.

• type deforestationTypes agora contém também a opção de Aquaculture para filtrar alertas com vetor de pressão de aquicultura;
• query version inserida para retornar a versão da API e detalhes de compilação.

• type AlertData campos para identificação de refinamento e boundingbox da image do alerta:
  • republished para identificar se o alerta foi retificado pós sua publicação inicial;
  • alertImageBbox com o boundingBox das imagems antes/depois do alerta;
• type classLabel
  • field colors foi marcado como depreciado, substituído pelo campo colors_with_labels para retornar as classes do Uso e Cobertura do MapBiomas Brasil e suas respectivas cores e legendas.

Esta documentação foi gerada sobre a versão 6.1.0-rc4-2026-10-15-19h24m.staging da plataforma no endpoint https://staging.plataforma.alerta.mapbiomas.org/api/v2/graphql no dia 2026-10-15-19h24m

---