Pular para o conteúdo principal
Um source é um dataset curado — tipicamente um registro de polígonos ou uma lista de identificadores de subject — usado como lado direito de um match. Exemplos:
  • funai_tis — registro oficial de terras indígenas
  • ibama_embargos — áreas embargadas por infrações ambientais
  • icmbio_ucs_federais — unidades de conservação federais
  • ofac_sdn — lista OFAC SDN dos EUA
  • sicar_br — Cadastro Ambiental Rural

Listando o que está disponível

GET /v1/sources
Retorna metadados de todo source que sua Organização pode acessar — nome, kind, cobertura por país e timestamp do último refresh. Filtrar por kind:
GET /v1/sources?kind=subject_register
Existem três kinds:
  • leaf — um source espacial regular.
  • group — uma coleção virtual que expande para várias leaves; selecionar um group é equivalente a consultar todos os seus membros.
  • subject_register — source não-espacial, indexado por identificadores tipados (CNPJ, EIN, OFAC SDN). Carrega uma lista supported_schemes.

Atualização

Cada source carrega collected_at_latest — o timestamp do último refresh. Os sources são atualizados em uma cadência apropriada à fonte upstream. Se uma fonte upstream estiver indisponível no momento da query, o check afetado é marcado como failed e o status do verdict vira degraded. A request ainda retorna 2xx com o resultado parcial, para que você decida como tratar.

Referenciando sources

Em um ruleset:
{
  "sets": {
    "protected_overlap": {
      "source": "icmbio_ucs_federais",
      "joins": [{ "intersects": { "target": "$input" } }]
    }
  }
}
Em /v1/intersections e /v1/distance, você pode consultar todos os sources de uma vez (default) ou restringir a um específico via reference_areas_source.