3 Get Results
โถStep 3: Get Results
Retrieve the processed entity results with completed metrics. Use steps 4aโ4d to fetch facilities, plots, and metric data for the full visualization.
โถWhat this step does
It reads the task's entities via GET /ingestions/assets/:id, asking for the
normalised_data and assessments includes. normalised_data gives you the
geocoded, matched fields for each uploaded row (name, country, commodity,
coordinates); assessments gives the confidence classification. Together they
are the per-entity result set โ the "what did my upload turn into" answer that
Step 2's status poll only summarised in counts.
โถWhy it's needed
Step 2 tells you the task is completed; this step tells you what
completed. The summary endpoint never returns row-level fields, so this is
where you actually see the normalised entities and their confidence levels.
It's also the anchor for the visualization: the metric endpoints (4c/4d) and
the location endpoints (4a/4b) are keyed by the same asset_task_id, and this
entity list supplies the names, commodities, and confidence that the metric
rows are joined against to build the results table.
โถWhy the include parameter
include parameterWithout include, the entity list omits the normalised fields and
assessments, so the results table would have no name, country, commodity, or
confidence columns to fill. Requesting both includes in one call avoids a
second round-trip. Drop an include only if you genuinely don't need that
slice โ e.g. omit assessments when you don't surface confidence.
โถRequest
GET /ingestions/assets/:id?include=normalised_data,assessments
โถAdditional Endpoints for Visualization
| Step | Endpoint | Data |
|---|---|---|
| 4a | GET /locations/facilities?filter[assets.task_id]=eq:{id} | Facility polygons for map |
| 4b | GET /locations/plots?filter[assets.task_id]=eq:{id} | Plot polygons for map |
| 4c | GET /metrics/sheds/deforestation?filter[assets.task_id]=eq:{id} | Deforestation metrics |
| 4d | GET /metrics/sheds/emissions?filter[assets.task_id]=eq:{id} | Emissions metrics |
โถCombined Assets Table
| Column | Source |
|---|---|
| Name | normalised_data.normalized_name |
| Location | normalised_data.normalized_country + lat/lng |
| Commodity | normalised_data.commodity_type |
| Confidence | assessments.core.confidence_level |
| Deforestation Risk | noncompliance_area / area from deforestation metrics |
| Forest Area (ha) | forest_area from deforestation metrics |
| LUC Emissions | luc from emissions metrics |
| Non-LUC Emissions | nonluc from emissions metrics |
โถNext Step
โ Step 4: Combined Visualization (chains 4aโ4d automatically)