08 Get Plot Deforestation Metrics
โถStep 8: Get Plot Deforestation Metrics
Read the finished deforestation series:
GET /metrics/plots/deforestation?filter[assets.task_id]=eq:{{plot_lifecycle_task_id}}.
One row per plot, each carrying the deforestation aggregates a dashboard
renders as a heatmap. This is the payoff of the workflow.
โถWhat this step does
It returns the per-plot deforestation time-series aggregates computed
by the job in steps 6โ7, scoped to this upload via
filter[assets.task_id]. Each row's attributes carries the numeric
series that downstream visualisation tooling turns into a heatmap.
โถWhy it's needed
This is the terminal read that closes the loop: everything before it
staged, validated, and computed; this step is where you actually retrieve
the deforestation numbers for the plots you uploaded. Scoping by
assets.task_id keeps the result to exactly this upload rather than the
org-wide metric surface.
โถWhy it's distinct from assessments.art9
assessments.art9This endpoint is the time-series surface โ the numeric series over
time. The art9 risk flag persisted under assessments.art9.flags (from
step 3) is the boolean decision (flagged vs not). Visualisation renders
the series here; compliance logic keys off the art9 flag. Read whichever
matches your question โ the map/heatmap comes from here.
This is the end of the Plot Ingestion workflow.