地图如何调用 API
公共客户端请求地图 API 的 bootstrap 端点，并接收 JSON 文档。请求明确要求最新内容并声明接受的格式。
在加载图层之前，应用会验证架构版本、快照版本和矢量瓦片路径。不兼容的合同会停止加载，避免显示含义不明确的数据。
| 操作 | 当前合同 |
|---|---|
| 地图 bootstrap | GET https://api.brasilterrasraras.com.br/v1/map/bootstrap?client=ownership-color-v1 |
| 格式 | application/json |
| 客户端缓存 | no-store |
快照合同
响应标识已发布数据集的版本和有效期，并提供运行计数，便于界面核验交付的数据量。
- v1
- 预期架构版本
- JSON
- 响应格式
- 3
- 每个来源的可能状态
- schemaVersion：预期的格式版本。
- snapshotVersion：已加载发布版本的标识。
- generatedAt 和 expiresAt：快照生成时间和有效期。
- counts：详细六边形、概览六边形、已评分区域、已关联区域和要素的总数。
交付的图层和来源
快照将矢量数据、要素集合和栅格叠加层分开。每个来源报告 pending、ready 或 error 状态，因此地图只会停用受影响的图层。
- 州界和矿产记录。
- GeoSGB 资源。
- 环境和地震事件。
- 包含瓦片地址的栅格叠加层。
- 机会区域使用的矢量瓦片路径。
文档范围
本页说明公共矿产地图使用的合同。它不代表通用开放 API，也不授予内部操作权限。