Magidoc

Consulta de cruzamentos

#

Para simplificar as consultas e melhorar a performance da API, os cruzamentos territoriais passaram a ser retornados de forma unificada pelo campo alertIntersections , disponível nas queries alert e alerts .


O que mudou?

#

Antes, cada tipo de cruzamento exigia campos específicos no AlertData , como crossedQuilombos , crossedQuilombosArea , crossedIndigenousLands , crossedConservationUnitsArea , crossedEmbargoesList , entre dezenas de outros campos que começam com crossed . Agora, um único campo consolida todos esses dados:

Antes (depreciado)
Agora (alertIntersections )
crossedQuilombos , crossedQuilombosArea , crossedQuilombosList
entrada com type quilombo
crossedIndigenousLands , crossedIndigenousLandsArea , crossedIndigenousLandsList
entrada com type indigenous_land
crossedConservationUnits , crossedConservationUnitsArea , crossedConservationUnitsList
entrada com type conservation_unit
crossedSettlements , crossedSettlementsArea , crossedSettlementsList
entrada com type settlement
crossedEmbargoesTotal , crossedEmbargoesArea , crossedEmbargoesList
entrada com type correspondente ao cruzamento de embargo
crossedFederalProtectedAreaIntegralProtections , crossedStateProtectedAreaSustainableUses , etc.
entrada com type e category do território protegido

Cada item de alertIntersections representa um tipo de cruzamento e traz:

  • type — identificador do tipo de cruzamento (ex.: quilombo , indigenous_land , conservation_unit , biome );
  • name — rótulo do tipo de cruzamento;
  • names — nomes dos territórios cruzados;
  • codes — códigos dos territórios cruzados;
  • category — categoria do território;
  • totalAreaHa — área total cruzada em hectares;
  • units — detalhamento por unidade territorial, com code , name , areaHa , crossAreaHa e version .

Exemplo de consulta

#

    
  

Variáveis

    
  

Exemplo de retorno

    
  

Para listar alertas com cruzamentos resumidos, utilize alertIntersections dentro de collection na query alerts:

    
  

Campos crossed* depreciados

#

Os campos que começam com crossed (como crossedQuilombos , crossedIndigenousLandsArea , crossedEmbargoesList , etc.) foram marcados como depreciados, mas continuam disponíveis nas queries alert e alerts para facilitar a migração gradual das integrações existentes.