Resource Type: Crops – Work Record

URLs

Get all work records that you have access to

GET /data/crops/work-records

Get an individual work record, regardless of its holding

GET /data/crops/work-records/{WorkRecordId}

Get all work records that you have access to for a given Holding, the HoldingId is required in this case

GET /data/holdings/{HoldingId}/crops/work-records

Get an individual work record for a given holding, both the HoldingId and the Id of the work record are required

GET /data/holdings/{HoldingId}/crops/work-records/{WorkRecordId}

Response Structure

A call to the Work Record endpoints returns the following fields:

{
    "resourceType": "/crop/work-record",
    "id": "string",
    "self": "string",
    "operation": "string",
    "status": "string",
    "priority": "string",
    "meta": { … }, 
    "observationDate": "2022-07-07T12:52:56.227Z", 
    "feature": { … }, 
    "holding": { … },
    "nonOverlapWorkedArea": { … },
    "workedArea": { … },
    "phenomenonStartTime": "2022-07-16T08:28:02:000Z",
    "phenomenonEndTime": "2022-07-16T10:18:02:000Z",
    "remark": "string",
    "responsible": "string",
    "loggedOperations":[ … ]
}
Response Item Description Data Type
Resource Type The fixed discriminator for the Crop Work Record resource type.
Value: /crop/work-record
String
Id The Pure Farming Id of this Work Record UUID
Self A link to this specific work record URI
Operation The operation performed on the crop String
Status The status of a work item (Valid values: Cancelled, Scheduled, InProgress, Complete, Paused, PartiallyCompleted) Enumeration
Priority The priority of a work item (Valid values: Immediately, SoonAsPossible, High, Medium, Low, null) Enumeration
Meta Meta data for the resource Metadata
Observation Date UTC date and time when the work record was observed DateTime
Phenomenon Start Time UTC date and time when the work started DateTime
Phenomenon End Time UTC date and time for when the work ended DateTime
Remark Notes or remarks String
Responsible Identifier of the person responsible for the work record String
Logged Operations Array of the operations completed in this work record Array of Operations

Operations

This represents an individual operation within the work record

{
    "resourceType": "/crop/operation-record",
    "id": "string",
    "identifiers": [ … ],
    "operation": "string",
    "operationName":"string",
    "meta": { … }, 
    "links": [ … ],
    "observationDate": "2022-07-07T12:52:56.227Z", 
    "feature": { … }, 
    "holding": { … },
    "phenomenonStartTime": "2022-07-16T08:28:02:000Z",
    "phenomenonEndTime": "2022-07-16T10:18:02:000Z",
    "remark": "string",
    "responsible": "string",
    "summaryGeometry": { … },
    "loggedGeometry": { … },
    "products": [ … ],
    "environment": { … }
}
Response Item Description Data Type
Resource Type The fixed discriminator for the operation record resource type.
Value: /crop/operation-record
String
Id The Pure Farming Id of this Operation Record UUID
Identifiers Any identifiers for this operation record Array of Identifiers
Operation The type (or identifier of the type) of operation String
Operation Name Human readable name of the field operation String
Meta Meta data for the resource Metadata
Links Any links relevant to this operation record Array of Links
Observation Date UTC date and time when this operation was observed DateTime
Feature The feature that this operation performed on Feature
Holding The Holding that this operation is linked to Feature
Phenomenon Start Time UTC date and time when the operation started DateTime
Phenomenon End Time UTC date and time for when the operation ended DateTime
Remark Notes or remarks String
Summary Geometry The geojson feature (with its geometry) that summarises the operation activity GeoJSON Feature
Logged Geometry The geojson feature (with its geometry) that covers the logged track or activity record in detail GeoJSON Feature
Products Products applied during the operation Array of Products
Environment Environmental data Environment

Products

A product applied during the operation

{
    "applicationRate": {
        "measurement": 10,
        "units": "KGM",
        "resoultion": 0.1
    },
    "spatialMetric":{
        "measurement": 10,
        "units": "MTK",
        "resoultion": 1
    },
    "applicationTotal":{
        "measurement": 100,
        "units": "KGM",
        "resoultion": 1
    },
    "components": [ … ]
}
Response Item Description Data Type
Application Rate The rate at which the product is applied Object
Spatial Metric The spatial metric to which the application rate applies e.g. per linear metre (MTR) or square metre (MTK) Object
Application Total The total amount of product applied Object
Components The components in this product mix (can be one) Array of Components

Note:
Units follow the UNCEFACT standard – see here


Environment

Environmental data for the operation

{
    "windSpeed":{
        "measurement":0,
        "resolution":1,
        "units":"MTS"
    },
    "windDirectionCompass":"E",
    "windDirectionDegrees":90,
    "airTemperature":{
        "measurement":10,
        "resolution":1,
        "units":"CEL"
    },
    "humidity":{
        "measurement":50,
        "resolution":1,
        "units":"P1"
    },
    "soilTemperature":{
        "measurement":10,
        "resolution":1,
        "units":"CEL"
    },
    "solarRadiation24hr":{
        "measurement":500,
        "resolution":1,
        "units":"D54"
    },
    "rainfall24hr":{
        "measurement":2.3,
        "resolution":0.1,
        "units":"MMT"
    }
}
Response Item Description Data Type
Wind Speed Wind speed (velocity) (Valid values for units: MTS, KNT, KMH, FR, HM, M19) Object
Wind Direction (Compass) Wind direction in compass points at the time of activity
(Valid values: N, NNE, NE, ENE, E, ESE, SE, SSE, S, SSW, SW, WSW, W, WNW, NW, NNW) Enumeration
Wind Direction (Degrees) Wind direction in decimal degrees at the time of activity Numeric
Air Temperature Air temperature at the time of activity (Valid values for units: KEL, CEL, FAH) Object
Humidity Humidity at the time of activity (Valid values for units: A93, P1, GK) Object
Soil Temperature Soil temperature at or near the time of activity (Valid values for units: KEL, CEL, FAH) Object
Solar Radiation (24 hours) Cumulative solar radiation over 24 hour period (Valid values for units: D54, B60 B13) Object

Note:
Units follow the UNCEFACT standard – see here


Components

A component in the product mix

{
    "mixSequence":1,
    "percent":100,
    "product": {
        "type":"string",
        "manufacturer":"string",
        "brand":"string",
        "form":"string",
        "uri":"string",
        "crop": { … },
        "specificGravity":1,
        "matterState":"Solid",
        "analysis":[ … ],
        "activeIngredients":[ … ],
        "withdrawals":[ … ],
        "claims":[ … ],
        "registrations":[ … ]
    }
}
Response Item Description Data Type
Mix Sequence The order of the product in the mix Integer
Percent The proportion that this product composes of the mix. Can be calculated from Wt/Vol or other measures Percentage
Product Type Defines types of product that can be used in field activities (Valid values: Unknown, Irrigation, Seed, Plant, Bulb, Tuber, Fertiliser, Pesticide, Fungicide, Herbicide, Adjuvant, Effluent, Biocontrol, Organic, HarvestedProduct, Mix) Enumeration
Product Manufacturer Manufacturer of the product String
Product Brand Brand of the product String
Product Form The physical form of the product (Valid values: Unknown, WettablePowder, WaterSolublePowder, WaterDispersableGranules, Granules, OrganicSolid, SuspensionConcentrate, SolubleConcentrate, EmulsifiableConcentrate, OrganicSuspension, Vapour, Gas) Enumeration
Product Uri A link to the product URI
Crop Defines a managed crop, or a species in a mixed sward Crop
Specific Gravity Relative density. The ratio of the density (mass of a unit volume) of a substance to the density of a given reference material. For liquids this is typically water at 4 degrees celcius Numeric
Matter State Matter states (Valid values: Unknown, Solid, Liquid, Gas) Enumeration
Analysis Used to specify analysis of a product (for example, nutrient or energy) Array of Analysis
Active Ingredients Array of active ingredients in the product Array of Active Ingredients
Withdrawals The withdrawal periods of the product Array of Withdrawals
Claims Claims associated with the product Array of Identifiers
Registrations Registrations associated with the product Array of Identifiers

Product Analysis

{
    "name":"Nitrogen",
    "percent":40,
    "id":{
        "id":"string",
        "scheme":"string"
    }
}
Response Item Description Data Type
Name Name of the product analysis String
Percent Proportion of the product analysis Number
Id Identifier of this analysis Identifier

Active Ingredients

An active ingredient of the product

{
    "name":"string",
    "id":"string",
    "scheme":"string"
}
Response Item Description Data Type
Name Human readable name of the product String
Id Official Id of the active ingredient String
Scheme Scheme of the id of the active ingredient String

Withdrawals

The withdrawal period of the product

{
    "scheme":"string",
    "hours":24
}
Response Type Description Data Type
Scheme The scheme controlling the withdrawal period rules String
Hours Duration of the withdrawal period in hours Number