Skip to main content

Cropzones

Cropzone Object​

FieldValue ExampleTypeDescriptionHow it Can Be Used
id"99af33b6-87f9-45d9-8f1b-afefb85f9f9f"String (UUID)Unique identifierReference specific cropzone
slug"cool-wind-42"StringHuman readable nameFor reference when humans are involved
name"cropzone 161542329"StringCropzone nameDisplay and identification
area199NumberSize of cropzoneArea calculations and planning
area_unit"m2"StringUnit of measurementArea unit
note"note for cropzone"StringAdditional informationFree text field used to add comments
labels[]ArrayTags/categoriesCategorization and filtering
timezone"UTC"StringTimezone of cropzoneTime-based calculations
start_date"2024-12-22T17:00:00Z"String (ISO 8601)Either planting date or creation date, prioritizing planting date if presentTimeline tracking
end_datenullString (ISO 8601)| nullAutomatically set to harvesting date when harvest occurs, null otherwiseDuration tracking
planting_date"2024-12-22T17:00:00Z"String (ISO 8601)| nullDate of plantingCrop lifecycle tracking
dap30Number | nullDays after plantingGrowth stage tracking
generation0NumberVersion/iteration numberTrack crop's generation (e.g sugarcane)
activities_count1NumberNumber of activitiesActivity tracking
soil_samples_count0NumberNumber of soil samplesSoil analysis tracking
preview_urihttps://maps.googleapis.com/maps/api/sta....String | nullPreview image URLVisual preview of the field on GMaps
location{ centroid: {...}, boundary: {...} }ObjectGeographic information including centroid point and boundary polygonSpatial analysis and mapping
location.centroid{ type: "Point", coordinates: [99.63, 19.25, 458.88] }ObjectCenter point of the cropzone with elevationLocation reference and elevation data
location.boundary{ type: "Polygon", coordinates: [[...]] }ObjectPolygon defining the cropzone boundariesArea definition and mapping
predicted{ maturity_date: "...", harvest: "..." }ObjectPrediction data for crop outcomesCrop planning and forecasting
predicted.maturity_date"2025-02-14T17:00:00Z"String (ISO 8601)| nullPredicted date of crop maturityHarvest planning
predicted.maturity_date_computed_at"2025-01-21T04:53:57Z"String (ISO 8601)| nullTimestamp when maturity date prediction was computedTrack prediction freshness
predicted.harvest"7.956080125"StringPredicted harvest amountYield forecasting
predicted.harvest_unit"tons"StringUnit of measurement for predicted harvestStandardize measurements
predicted.harvest_computed_at"2025-01-21T04:53:57Z"String (ISO 8601)| nullTimestamp when harvest prediction was computedTrack prediction freshness
predicted.yield"0.0008258335193066223"StringPredicted yield per area unitProductivity forecasting
predicted.yield_unit"tons/m2"StringUnit of measurement for predicted yieldStandardize measurements
predicted.yield_computed_at"2025-01-21T04:53:57Z"String (ISO 8601)| nullTimestamp when yield prediction was computedTrack prediction freshness
actual{ harvesting_date: "...", harvest: "..." }ObjectActual harvest resultsPerformance analysis
actual.harvesting_date"2022-05-13T17:00:00Z"String (ISO 8601)Actual date of harvestHistorical record
actual.harvest"4.31"StringActual harvest amountYield analysis
actual.harvest_unit"tons"StringUnit of measurement for actual harvestStandardize measurements
actual.yield"0.0024078212290502793"StringActual yield per area unitProductivity analysis
actual.yield_unit"tons/m2"StringUnit of measurement for actual yieldStandardize measurements
season{ id: "...", name: "...", start_datetime: "..." }ObjectSeason information for the cropzoneSeasonal tracking and analysis
season.id"season-uuid"String (UUID)Unique identifier for the seasonSeason reference
season.name"Season 2024"StringName of the seasonSeason identification
season.start_datetime"2024-01-01T00:00:00Z"String (ISO 8601)Start date of the seasonSeason timeline tracking
season.end_datetime"2024-12-31T23:59:59Z"String (ISO 8601)End date of the seasonSeason duration tracking
rs_stopped_at"2023-08-29T08:05:10Z"String (ISO 8601)Datetime when remote sensing image fetching stoppedRemote sensing data tracking
farm{ id: "...", name: "...", phone: "..." }ObjectFarm information associated with cropzoneFarm tracking and management
farm.id"0ee2865f-45bb-48f8-a56e-2161284ec358"String (UUID)Unique identifier of associated farmFarm reference
farm.name"Osinski, Terry and Fadel"StringName of associated farmFarm identification
farm.phone"+819012345678"String | nullContact phone number for the farmFarm communication
field{ id: "...", name: "..." }ObjectField information associated with cropzoneField tracking and management
field.id"d48e193f-b1b7-469a-a4fe-453e131cbb86"String (UUID)Unique identifier of associated fieldField reference
field.name"field 278614995"StringName of associated fieldField identification
cropCrop ObjectObjectCrop information associated with cropzoneCrop tracking and management
seed_usage3Number | nullAmount of seeds usedSeed usage tracking
seed_usage_unit"kg"String | nullUnit of measurement for seed usage ("kg" or "bags")Know the unit used for seeds usage

The start_date field uses the planting_date when specified; if no planting date exists, it uses the cropzone's created_at date. The end_date field remains null until a harvest occurs, at which point it's set to the harvesting_date.