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

This 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.