Como o mapa consome a API
O cliente público consulta o endpoint de bootstrap da API de mapa e recebe um documento JSON. A leitura solicita conteúdo atualizado e declara explicitamente o formato aceito.
Antes de montar as camadas, a aplicação valida a versão do esquema, a versão do snapshot e o caminho dos mosaicos vetoriais. Um contrato incompatível interrompe o carregamento em vez de exibir dados ambíguos.
| Operação | Contrato atual |
|---|---|
| Bootstrap do mapa | GET https://api.brasilterrasraras.com.br/v1/map/bootstrap?client=scientific-view-v1 |
| Formato | application/json |
| Cache no cliente | 60 segundos, com revalidação |
Contrato do snapshot
A resposta identifica a versão e a validade do conjunto publicado. Também apresenta contagens operacionais para que a interface consiga verificar o volume entregue.
- v1
- versão esperada do esquema
- JSON
- formato de resposta
- 3
- estados possíveis por camada
- schemaVersion: versão esperada do formato.
- snapshotVersion: identificador da publicação carregada.
- generatedAt e expiresAt: geração e validade do snapshot.
- counts: totais de células científicas detalhadas, células de visão geral e feições publicadas.
Camadas Brasil Terras Raras entregues
O snapshot separa dados vetoriais, coleções de feições e sobreposições raster. Cada camada informa seu estado como pending, ready ou error, permitindo que o mapa indisponibilize somente a parte afetada.
- Estados e registros minerais.
- Recursos do acervo Brasil Terras Raras.
- Eventos ambientais e sísmicos.
- Sobreposições raster com seus endereços de mosaicos.
- Caminho dos mosaicos vetoriais usados nas áreas de oportunidade.
Catálogo científico dinâmico
O painel também consulta um manifesto versionado e localizado com os modos de análise, domínios de dados, terras raras, elementos indicadores, perfis geoquímicos e camadas publicáveis. Esse catálogo é independente do mapa legado e não transforma dados históricos em resultado científico aprovado.
| Operação | Contrato atual |
|---|---|
| Manifesto público | GET https://mineral-api.brasilterrasraras.com.br/v1/manifest |
| Contrato | btr-manifest-v1 |
| Estado atual | unavailable · zero camadas aprovadas |
Escopo documentado
Esta página descreve o contrato consumido pela experiência pública do Mapa Mineral. Ela não anuncia uma API aberta de uso geral nem concede acesso a operações internas.