Ingestion Supplier Units
Each supplier unit an ingestion grouped its locations into, with the unit's supply shed and the unit's readings.
โถUse Cases
- Draw every supply shed of an ingestion on a map, at any later stage of the journey.
- Show a plot's hazard, water, infrastructure, landscape and legality
readings as what they are: values for the plot's supply shed, not
measurements of the plot itself. Match a location to its unit through the
supplier_unitfield on the ingestion's location results.
โถBehaviour
basissays how the shed was drawn.travel_time: the refined travel-time supply shed.straight_line: units grouped by distance before refinement finished. There is no shed yet.uploaded: units from the file's ownsupplier_unitcolumn. These have no computed shed.site: a single place, which has no shed.
- Refinement after creation. When refinement lands after the ingestion
was created, the next read serves the refined shed and
basischanges totravel_time.refinementispendingwhile a refinement may still land,completeonce none is left, andunavailableonce none can land. - Plot readings come from here. A plot's hazard, water, biodiversity,
infrastructure and legality readings are this unit's, and the plot's
assessments say so with
supply_shed.supplier_unit_id. - Kept for the life of the ingestion. Units do not expire with the validation service's cache.
- Each reading says what it was measured over (
measured_on):supplier_unit: the catchment around the unit's plots (hazard, water, ports, roads, landscape, water budget, catchment deforestation). This is not thegeometryserved beside it, and a refinement that redrawsgeometrydoes not re-measure the readings.commodity_country: the commodity and country group the unit belongs to (legality and the other name- or country-driven checks).
โถErrors
404 NOT_FOUND: unknown task id, or a task belonging to another organization.
Required scope:
ingestions:read