Formato de dados

O perfil DCAT do Governo Federal, o formato canônico de resposta e o bloco de atribuição obrigatório.

A Acácia não inventa um padrão novo. Os metadados do catálogo seguem o perfil DCAT (Data Catalog Vocabulary, W3C) adotado pelo Governo Federal no dados.gov.br — o mesmo vocabulário usado para catalogar dados abertos no Brasil. Adotar um padrão existente e declará-lo canônico é uma decisão de arquitetura: qualquer provedor que já publica no padrão do governo entra na Acácia sem tradução.

Os três blocos do formato

Todo indicador na Acácia é descrito em três camadas:

Catálogo (DCAT) — quem publica, sob qual licença, com qual descrição. É o que a busca vetorial indexa.
Definição do indicador — nome canônico, slug, categoria, unidade.
Valores — a série de observações, sempre indexada por geocode IBGE (o código de 7 dígitos do município) e ano.

O item de resultado canônico

Cada elemento de results em uma resposta de busca tem exatamente esta forma:

{
  "indicator": "indice-de-estresse-hidrico",
  "name": "Índice de estresse hídrico",
  "category": {
    "slug": "seguranca-hidrica",
    "name": "Segurança Hídrica"
  },
  "territory": {
    "geocodeIbge": "2927408",
    "name": "Salvador",
    "uf": "BA"
  },
  "period": 2022,
  "value": 0.61,
  "class": "Alto",
  "relevance": 0.83,
  "attribution": {
    "provider": "Adapta Brasil",
    "publisher": "Adapta Brasil / MCTI",
    "sourceUrl": "https://adaptabrasil.mcti.gov.br",
    "license": "CC-BY 4.0",
    "citation": "Adapta Brasil / MCTI. Índice de estresse hídrico, 2022. Via Acácia (Adapta Brasil)."
  }
}

Campo a campo

Campo	Significado
`indicator`	Slug canônico do indicador no provedor.
`name`	Nome legível do indicador.
`category`	Categoria temática (slug + nome), herdada do catálogo do provedor.
`territory.geocodeIbge`	Código IBGE de 7 dígitos do município. É a chave territorial de toda a Acácia.
`territory.uf`	UF derivada dos 2 primeiros dígitos do geocode.
`period`	Ano da observação.
`value`	O valor numérico, exatamente como reportado pelo provedor. Pode ser `null`.
`class`	Classificação qualitativa do provedor: `Muito baixo`, `Baixo`, `Médio`, `Alto`, `Muito alto`.
`relevance`	Similaridade semântica entre a consulta e o indicador (0–1).
`attribution`	Bloco de crédito obrigatório — descrito abaixo.

O bloco `attribution` é obrigatório

Nenhuma resposta da Acácia sai sem atribuição. O bloco carrega:

provider — o nome do provedor conectado à Acácia (a infraestrutura que serviu o dado).
publisher — a instituição que produz o dado (a autoria intelectual).
sourceUrl — onde encontrar a fonte original.
license — a licença de uso declarada pelo publicador.
citation — citação pronta, no formato Publicador. Indicador, ano. Via Acácia (provedor).

Se você exibe dados da Acácia em qualquer interface, exiba a atribuição junto. Se alimenta uma IA, inclua o bloco no contexto — é ele que permite ao modelo citar a fonte.

Por que geocode IBGE?

Nome de município é ambíguo (existem quatro "Bom Jesus" no Brasil) e muda de grafia entre bases. O geocode de 7 dígitos do IBGE é estável, único e permite derivar a UF, a mesorregião e agregações territoriais. Todo valor na Acácia é indexado por (geocodeIbge, ano) — e toda consulta com município passa por resolução de geocode antes de buscar valores.