Size

Recommended patterns for fetching TrueFruit size data

How to fetch fruit size distributions per orchard

First pull per orchard size measurement dates for a given time period using the farming/truefruit/size/measurements/ endpoint. The response will return a list of objects containing an orchard_id and measurement_date. Filter the response using the processed_date query parameter. Using the processed_date is the most robust approach as it avoids losing records where there is a large delay between the data collection date and when it became available to consume. If you are fetching data on a cron, for example once a day, you will use the date you last fetched data on.
To fetch the detailed orchard size distributions and aggregated metrics, pass the orchard_id and measurement_date received in the farming/truefruit/size/measurements/ response into the farming/truefruit/size/measurements/{orchard_id}/{measurement_date} endpoint. This will return a size distribution array which contains the histogram bucket ranges and the percentage of fruit which fall in each bucket.

How to fetch forecasted size distributions per orchard

First pull per orchard size measurement dates for a given time period using the farming/truefruit/size/forecasts/ endpoint. The response will return a list of objects containing an orchard_id and measurement_date. Filter the response using the processed_date query parameter. Using the processed_date is the most robust approach as it avoids losing records where there is a large delay between the data collection date and when it became available to consume. If you are fetching data on a cron, for example once a day, you will use the date you last fetched data on.
To fetch the detailed orchard size distributions and aggregated metrics, pass the orchard_id and measurement_date received in the farming/truefruit/size/forecasts/ response into the farming/truefruit/size/forecasts/{orchard_id}/{forecast_date} endpoint. This will return a size distribution array which contains the histogram bucket ranges and the percentage of fruit which fall in each bucket.

Key	Type	Description
`farm_id`	Integer	The unique identifier for the farm which is provided by Aerobotics.
`orchard_id`	Integer	The unique identifier of the orchard .
`measurement_date`	Date	The date when the fruit measurements were taken.
`processed_date`	Date	The date when the data was processed by Aerobotics.
`average_fruit_size_mm`	Number	The average fruit size for the collection in mm.

Key	Type	Description
`farm_id`	Integer	The unique identifier of the farm, provided by Aerobotics, which the measurement belongs to.
`orchard_id`	Integer	The unique identifier of the orchard, provided by Aerobotics, which the measurement belongs to.
`measurement_date`	Date	The date that the bin images were captured by the user
`processed_date`	Date	The date that the measurement data completed processing by Aerobotics
`size_distribution[]`	[Distribution Record]	An array of distribution records that can be used to build a histogram of fruit sizes
`average_fruit_size_mm`	Number	The average fruit size
`count_fruit_measured`	Integer	The number of individual fruit measured

Key	Type	Description
`bin_range`	String	Size range of the histogram bin in millimeters
`percentage`	Number	Percentage of fruit sizes that fall within the corresponding bin range
`label`	String \| Null	Name of the histogram bin range. Typically the harvest size category names. (optional)

Key	Type	Description
`farm_id`	Integer	The unique identifier for the farm which is provided by Aerobotics.
`orchard_id`	Integer	The unique identifier of the orchard .
`forecast_date`	Date	The date for which the size forecast was generated.
`processed_date`	Date	The date when the data was processed by Aerobotics.
`average_fruit_size_mm`	Number	The forecasted average fruit size in mm.

Fetch fruit size distributions for orchards processed within the last day

Open Recipe

Fetch TrueFruit Size Distributions with 1mm Increments

Open Recipe