Retrieve survey records by orchard and date, including survey area, polygon data, and related orthomosaic downloads from drone mapping.
Use these endpoints to retrieve survey records for orchards mapped by drone, including the survey area, polygon data, and related orthomosaic downloads. The data supports three endpoint types:
- Multiple surveys — Returns survey records for a filtered set of surveys.
- Single survey — Returns the survey record for a single survey.
- Orthomosaic download URL — Returns a presigned orthomosaic download URL for a single survey.
A survey represents a point in time when an orchard was mapped by drone. Use Get multiple surveys to retrieve survey records for a filtered set of surveys, Get a survey to retrieve a single survey record, and Get a download URL for a survey orthomosaic to request a presigned orthomosaic download URL using the survey id.
Survey Object
| Key | Type | Description |
|---|---|---|
| id | Integer | The unique identifier of the survey, provided by Aerobotics. |
| orchard_id | Integer | The unique identifier of the orchard. |
| date | String | The date on which the survey was flown. Format: YYYY-MM-DD. |
| hectares | Number | The orchard area in hectares at the time of the survey. |
| polygon | String | The survey polygon, returned as a string of lng,lat pairs split by . |
Example response
{
"id": 12345,
"orchard_id": 6789,
"date": "2025-11-15",
"hectares": 14.2,
"polygon": "12.123,-15.123 12.124,-15.124 12.122,-15.122 12.123,-15.123"
}