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_unit field on the ingestion's location results.

Behaviour

  • basis says 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 own supplier_unit column. 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 basis changes to travel_time. refinement is pending while a refinement may still land, complete once none is left, and unavailable once 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 the geometry served beside it, and a refinement that redraws geometry does 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