Plot Metrics
Metrics computed for individual plots โ the most granular level. Plot metrics are calculated directly from each plot's geometry, and are the source values that shed and facility metrics are aggregated from.
Each metric family โ Deforestation, Emissions, Biodiversity, Water Stress โ is available under /metrics/plots/<metric> with the same shape:
| Endpoint | Returns |
|---|---|
GET /metrics/plots/<metric> | Latest value per plot (one row per plot). |
GET /metrics/plots/<metric>/history | All historical results across plots. |
GET /metrics/plots/:id/<metric>/history | History for a single plot. |
GET /metrics/plots/<metric> (single-location) | Latest value filtered to one plot. |
| By commodity | The same metric scoped to a single commodity. |
Supports filtering, pagination (cursor recommended at scale), and JSON / GeoJSON / streaming formats. Deforestation additionally supports filter[deforestation_period] to select the EUDR or user monitoring window. See Query Parameters and Metric Methodology.
Required scope:
metrics:read