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=ownership-color-v1 |
| Formato | application/json |
| Caché del cliente | no-store |
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 fuente
- 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 hexágonos detallados, hexágonos generales, áreas puntuadas, áreas vinculadas y entidades.
Capas y fuentes entregadas
El snapshot separa datos vectoriales, colecciones de entidades y superposiciones raster. Cada fuente informa su estado como pending, ready o error, lo que permite deshabilitar únicamente la capa afectada.
- Estados y registros minerales.
- Recursos de GeoSGB.
- Eventos ambientales y sísmicos.
- Superposiciones raster con sus direcciones de mosaicos.
- Ruta de los mosaicos vectoriales usados en las áreas de oportunidad.
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.