Cómo consume el mapa la API
El cliente público consulta el endpoint de bootstrap de la API del mapa y recibe un documento JSON. La solicitud pide contenido actualizado y declara de forma explícita el formato aceptado.
Antes de montar las capas, la aplicación valida la versión del esquema, la versión del snapshot y la ruta de los mosaicos vectoriales. Un contrato incompatible detiene la carga en lugar de mostrar datos ambiguos.
| Operación | Contrato actual |
|---|---|
| Bootstrap del mapa | GET https://api.brasilterrasraras.com.br/v1/map/bootstrap?client=scientific-view-v1 |
| Formato | application/json |
| Caché del cliente | 60 segundos, con revalidación |
Contrato del snapshot
La respuesta identifica la versión y la vigencia del conjunto publicado. También presenta conteos operativos para que la interfaz pueda verificar el volumen entregado.
- v1
- versión esperada del esquema
- JSON
- formato de respuesta
- 3
- estados posibles por capa
- schemaVersion: versión esperada del formato.
- snapshotVersion: identificador de la publicación cargada.
- generatedAt y expiresAt: generación y vigencia del snapshot.
- counts: totales de celdas científicas detalladas, celdas generales y entidades publicadas.
Capas Brasil Terras Raras entregadas
El snapshot separa datos vectoriales, colecciones de entidades y superposiciones raster. Cada capa informa su estado como pending, ready o error, lo que permite deshabilitar únicamente la parte afectada.
- Estados y registros minerales.
- Registros de recursos Brasil Terras Raras.
- Eventos ambientales y sísmicos.
- Superposiciones raster con sus direcciones de mosaicos.
- Ruta de los mosaicos vectoriales usados en las áreas de oportunidad.
Catálogo científico dinámico
El panel también consulta un manifiesto versionado y localizado con modos de análisis, dominios de datos, tierras raras, elementos indicadores, perfiles geoquímicos y capas publicables. Este catálogo es independiente del mapa heredado y no convierte datos históricos en un resultado científico aprobado.
| Operación | Contrato actual |
|---|---|
| Manifiesto público | GET https://mineral-api.brasilterrasraras.com.br/v1/manifest |
| Contrato | btr-manifest-v1 |
| Estado actual | unavailable · cero capas aprobadas |
Alcance documentado
Esta página describe el contrato consumido por la experiencia pública del Mapa Mineral. No anuncia una API abierta de uso general ni concede acceso a operaciones internas.