地图如何调用 API
公共客户端请求地图 API 的 bootstrap 端点，并接收 JSON 文档。请求明确要求最新内容并声明接受的格式。
在加载图层之前，应用会验证架构版本、快照版本和矢量瓦片路径。不兼容的合同会停止加载，避免显示含义不明确的数据。
| 操作 | 当前合同 |
|---|---|
| 地图 bootstrap | GET https://api.brasilterrasraras.com.br/v1/map/bootstrap?client=scientific-view-v1 |
| 格式 | application/json |
| 客户端缓存 | 60 秒，并进行重新验证 |
快照合同
响应标识已发布数据集的版本和有效期，并提供运行计数，便于界面核验交付的数据量。
- v1
- 预期架构版本
- JSON
- 响应格式
- 3
- 每个图层的可能状态
- schemaVersion：预期的格式版本。
- snapshotVersion：已加载发布版本的标识。
- generatedAt 和 expiresAt：快照生成时间和有效期。
- counts：详细科研单元、概览单元和已发布要素的总数。
交付的 Brasil Terras Raras 图层
快照将矢量数据、要素集合和栅格叠加层分开。每个图层报告 pending、ready 或 error 状态，因此地图只会停用受影响的部分。
- 州界和矿产记录。
- Brasil Terras Raras 资源记录。
- 环境和地震事件。
- 包含瓦片地址的栅格叠加层。
- 机会区域使用的矢量瓦片路径。
动态科学目录
图层面板还会请求一个带版本和本地化文本的清单，其中包含分析模式、数据领域、稀土元素、指示元素、地球化学剖面和可发布图层。该目录独立于旧版地图，不会把历史数据转化为已获批的科学结论。
| 操作 | 当前合同 |
|---|---|
| 公共清单 | GET https://mineral-api.brasilterrasraras.com.br/v1/manifest |
| 合同 | btr-manifest-v1 |
| 当前状态 | unavailable · 已批准图层为零 |
文档范围
本页说明公共矿产地图使用的合同。它不代表通用开放 API，也不授予内部操作权限。