Introduction

Welcome to the Aerobotics API docs for developers.

Aerobotics

Aerobotics is a AgriTech data analytics and AI business that uses drones to collect data at scale and computer vision to estimate yields, detect pests and disease, and provide actionable insights for its clients to manage the health of their crops.

Why the Aerobotics API?

All data is exposed to our clients through our web application, Aeroview, and mobile application, Aeroview InField. The API offers the ability for our clients to pull this data automatically and integrate it directly into their internal systems.

Available Data

Our REST API is a read only API. You can use it to pull data into your own system.

The Aerobotics REST API provides access to comprehensive agricultural data across the complete farming workflow. Here's what you can fetch:

Farm Data

  • Farm Information: Farm details including name, total hectares, orchard count, owner information, organization name, external ID, and grouping
  • Bin Data: Bin records associated with farms, including farm ID, orchard ID, and external ID

Orchard Data

  • Orchard Information: Name, farm ID, crop type, polygon boundaries, hectares, cultivar name/ID, and external ID

Survey Data

  • Survey Records: Survey ID, orchard ID, date, hectares, and the polygon of the surveyed area
  • Orthomosaics: Downloadable imagery for a survey via presigned URLs in multiple bands:
    • Visual (RGB)
    • DEM (Depth map)
    • Red multispectral
    • NIR (Near infrared)
    • REG (Red edge)
    • LWIR (Thermal)
    • NDVI (Normalized Difference Vegetation Index)
    • NDRE (Normalized Difference Red Edge Index)

Tree Analysis Data

  • Tree Groups: Tree group information including name, orchard ID, plant date, cultivar ID, rootstock ID
  • Tree Survey Summary: Aggregate statistics including:
    • Tree count and missing tree count
    • Average and standard deviation of canopy area (m²)
    • Average and standard deviation of NDRE values
  • Individual Tree Surveys: Detailed tree-level data including:
    • GPS coordinates (lat/lng)
    • NDRE and NDVI values
    • Canopy volume and area
    • Row and tree index positions
  • Missing Trees: GPS coordinates for trees detected as dead or removed from the orchard
  • Zones: Survey-level orchard zones segmented by health or performance, including aggregate metrics and polygon regions

TrueFruit Size Data

  • Size Measurements: Fruit size distribution data including:
    • Average fruit size in millimeters
    • Count of fruit measured
    • Size distributions in various formats (1mm, 2mm, 2.5mm, 5mm intervals or harvest categories)
    • Optional fruit length and mass distributions for supported cultivars
    • Sample position averages with GPS coordinates
  • Size Forecasts: Predicted fruit size distributions with percentage breakdowns by total count and total mass

TrueFruit Grade Data

  • Grade Measurements: Fruit quality assessment data including:
    • Size distributions
    • Blemish distribution (quality defect analysis)
    • Color distribution
    • Average fruit size and count fruit measured
    • Sample position averages with GPS coordinates
    • Fruit unit level (individual fruit vs bunch for grapes)
    • Optional bunch width and bunch length distributions for supported bunch-level responses

TrueFruit Manual Fruit Count Data

  • Manual Fruit Count Measurements: Field-sampled fruit count data including:
    • Tree-level fruit counts and vine-level bunch counts
    • Sample type and fruit unit information
    • Average fruit count per sample position
    • Individual sample positions with GPS coordinates
    • Optional bunch detail, including average berries per bunch

TrueFruit Binscan Data

  • Binscan Measurements: Post-harvest fruit analysis including:
    • Size, blemish, and color distributions
    • Picking quality summaries
    • Bin-level and bin-group-level data aggregation
    • Individual bin distributions with external IDs and GPS coordinates
    • Total bin counts

Data Filtering Options

All endpoints support various filtering parameters:

  • Date Filters: Filter by measurement date, processed date, forecast date
  • ID Filters: Filter by farm ID, orchard ID, survey ID
  • Pagination: Limit and offset parameters for large datasets
  • Granularity Options: Different aggregation levels (orchard, bin, bin group)
  • Distribution Format Options: Choose size distribution bucket formats on supported endpoints
  • Optional Detail Parameters: Include additional detail such as bunch-level dimension fields on supported endpoints

Technical queries

If you need support with using the API please send an email to [email protected]


Up next

Learn how to authenticate against the Aerobotics API.