6d Get Emissions Metrics
โถStep 6d: Get Emissions Metrics
Retrieve emissions metrics for all facilities in the task. Join these to the assets table and map tooltips by facility relationship ID.
โถWhat this step does
It reads the per-shed emissions results from /metrics/sheds/emissions,
scoped by filter[assets.task_id]. Each metric carries the carbon
figures โ luc, nonluc, removal, soc, biogenic, area โ and a
facility (and shed) relationship for joining back to the locations.
โถWhy it's needed
Emissions is the second half of the metric run triggered in Step 4, and
like deforestation it lives on its own resource rather than on the
facility. This read supplies the LUC / non-LUC columns in the assets
table and the carbon figures in the map tooltips. It only returns data
when emissions was included in the Step 4 metrics list.
โถWhen you can skip it
Skip it if you only requested deforestation in Step 4 โ with no
emissions run there are no rows to fetch, and the combined visualization
simply omits the emissions columns. It's also facility-oriented, so
plot-only uploads have nothing to join here.
โถRequest
GET /metrics/sheds/emissions?filter[assets.task_id]=eq:{process-task-id}
Query parameters:
| Parameter | Description |
|---|---|
filter[assets.task_id] | Process task ID from Step 4 |
filter[commodity] | Filter by commodity type |
filter[country_code] | Filter by country code |
page[number] | Page number |
page[size] | Items per page |
โถData Joining
- Match
relationships.facility.data.idto facility IDs from Step 6a - Or match
relationships.shed.data.idto plot IDs from Step 6b - Same joining strategy as deforestation metrics (Step 6c)
โถAssets Table Columns
| Column | Source | Description |
|---|---|---|
| LUC Emissions (tCO2e/yr) | luc | Land-use change emissions |
| Non-LUC Emissions (tCO2e/yr) | nonluc | Non-land-use change emissions |
โถMap Tooltip Data
luc: Land-use change emissions (tCO2e/yr)nonluc: Non-land-use change emissions (tCO2e/yr)removal: Carbon removal (tCO2e/yr, negative value)soc: Soil organic carbon (tCO2e/yr)biogenic: Biogenic emissions (tCO2e/yr)area: Total analyzed area in hectares