Field Facts API

API change history

This API offers users the ability to access multiple field-level datasets including critical sustainability factors of soil type, weather, altitude and natural habitats.

  • Long-term averages for monthly temperatures - minimum, maximum, mean, days of air frost
  • Long-term averages for monthly rainfall - total (precipitation in mm), days over 1mm, days over 10mm
  • Long-term averages for growing degree days - base 5.5°C (applicable to wheat and other cereals)
  • Topsoil and subsoil textures (using USDA definitions for particle size thresholds and for soil texture based on component percentages)
  • Topsoil chemistry and biological parameters
  • Altitude
  • Priority habitats within or in the neighbourhood of the field
  • Water catchment information from the Water Framework Directive.

facts

Retrieve field facts associated to a field identifer.

Try it

Request

Request URL

Request parameters

  • string

Request headers

  • string
    Subscription key which provides access to this API. Found in your Profile.

Request body

Responses

200 OK

Search location matches a field and an identifier is returned.

Representations

{
  "_links": {
    "ag:api:field-trends": {
      "href": "https://api.agrimetrics.co.uk/field-trends/FIELD_ID"
    },
    "ag:api:field-forecasts": {
      "href": "https://api.agrimetrics.co.uk/field-forecasts/FIELD_ID"
    },
    "self": {
      "href": "https://api.agrimetrics.co.uk/field-facts/FIELD_ID"
    }
  },
  "@context": "https://api.agrimetrics.co.uk/field-facts/context",
  "@id": "https://data.agrimetrics.co.uk/fields/FIELD_ID",
  "hasLongTermAverageMonthlyMinimumTemperature": {
    "@type": "Dataseries",
    "hasDimension": "http://data.agrimetrics.co.uk/dimensions/min-temperature",
    "hasFrequency": "http://data.agrimetrics.co.uk/frequencies/monthly",
    "hasUnit": "http://data.agrimetrics.co.uk/units/celsius",
    "hasDatapoint": [
      {
        "@type": "Datapoint",
        "value": -0.3,
        "month": 12
      }
    ]
  },
  "hasLongTermAverageMonthlyMaximumTemperature": {
    "@type": "Dataseries",
    "hasDimension": "http://data.agrimetrics.co.uk/dimensions/max-temperature",
    "hasFrequency": "http://data.agrimetrics.co.uk/frequencies/monthly",
    "hasUnit": "http://data.agrimetrics.co.uk/units/celsius",
    "hasDatapoint": [
      {
        "@type": "Datapoint",
        "value": 12.5,
        "month": 12
      }
    ]
  },
  "hasLongTermAverageMonthlyMeanTemperature": {
    "@type": "Dataseries",
    "hasDimension": "http://data.agrimetrics.co.uk/dimensions/mean-temperature",
    "hasFrequency": "http://data.agrimetrics.co.uk/frequencies/monthly",
    "hasUnit": "http://data.agrimetrics.co.uk/units/celsius",
    "hasDatapoint": [
      {
        "@type": "Datapoint",
        "value": 5.8,
        "month": 12
      }
    ]
  },
  "hasLongTermAverageMonthlyTotalRainfall": {
    "@type": "Dataseries",
    "hasDimension": "http://data.agrimetrics.co.uk/dimensions/rainfall",
    "hasFrequency": "http://data.agrimetrics.co.uk/frequencies/monthly",
    "hasUnit": "http://data.agrimetrics.co.uk/units/millimetre",
    "hasDatapoint": [
      {
        "@type": "Datapoint",
        "value": 39.44,
        "month": 12
      }
    ]
  },
  "hasLongTermAverageMonthlyHoursOfSunshine": {
    "@type": "Dataseries",
    "hasDimension": "http://data.agrimetrics.co.uk/dimensions/hours-of-sunshine",
    "hasFrequency": "http://data.agrimetrics.co.uk/frequencies/monthly",
    "hasUnit": "http://data.agrimetrics.co.uk/units/hours",
    "hasDatapoint": [
      {
        "@type": "Datapoint",
        "value": 10.44,
        "month": 12
      }
    ]
  },
  "hasLongTermAverageMonthlyDaysOfRainfallAbove1mm": {
    "@type": "Dataseries",
    "hasDimension": "http://data.agrimetrics.co.uk/dimensions/days-of-rainfall-above-1mm",
    "hasFrequency": "http://data.agrimetrics.co.uk/frequencies/monthly",
    "hasUnit": "http://data.agrimetrics.co.uk/units/days",
    "hasDatapoint": [
      {
        "@type": "Datapoint",
        "value": 12.5,
        "month": 12
      }
    ]
  },
  "hasLongTermAverageMonthlyDaysOfRainfallAbove10mm": {
    "@type": "Dataseries",
    "hasDimension": "http://data.agrimetrics.co.uk/dimensions/days-of-rainfall-above-10mm",
    "hasFrequency": "http://data.agrimetrics.co.uk/frequencies/monthly",
    "hasUnit": "http://data.agrimetrics.co.uk/units/days",
    "hasDatapoint": [
      {
        "@type": "Datapoint",
        "value": 5.5,
        "month": 12
      }
    ]
  },
  "hasLongTermAverageMonthlyDaysOfAirFrost": {
    "@type": "Dataseries",
    "hasDimension": "http://data.agrimetrics.co.uk/dimensions/days-of-air-frost",
    "hasFrequency": "http://data.agrimetrics.co.uk/frequencies/monthly",
    "hasUnit": "http://data.agrimetrics.co.uk/units/days",
    "hasDatapoint": [
      {
        "@type": "Datapoint",
        "value": 17.5,
        "month": 12
      }
    ]
  },
  "hasLongTermAverageMonthlyDaysOfGroundFrost": {
    "@type": "Dataseries",
    "hasDimension": "http://data.agrimetrics.co.uk/dimensions/days-of-ground-frost",
    "hasFrequency": "http://data.agrimetrics.co.uk/frequencies/monthly",
    "hasUnit": "http://data.agrimetrics.co.uk/units/days",
    "hasDatapoint": [
      {
        "@type": "Datapoint",
        "value": 21.8,
        "month": 12
      }
    ]
  },
  "hasLongTermAverageMonthlyGrowingDegreeDays": {
    "@type": "Dataseries",
    "hasDimension": "http://data.agrimetrics.co.uk/dimensions/growing-degree-days",
    "hasFrequency": "http://data.agrimetrics.co.uk/frequencies/monthly",
    "hasUnit": "http://data.agrimetrics.co.uk/units/degree-days",
    "hasDatapoint": [
      {
        "@type": "Datapoint",
        "value": 21.8,
        "month": 12
      }
    ]
  },
  "hasRepresentativePoint": {
    "@type": "Point",
    "altitude": 134
  },
  "hasSoilLayer": [
    {
      "@type": "SoilLayer",
      "hasSoilLayerType": "http://data.agrimetrics.co.uk/soil-layer-types/topsoil",
      "hasSoilTexture": {
        "@type": "SoilTexture",
        "hasSoilTextureType": "http://data.agrimetrics.co.uk/soil-texture-types/sandy-clay-loam",
        "sandPercentage": 32.5,
        "clayPercentage": 46.2,
        "siltPercentage": 21.3
      },
      "hasChemicalProperty": {
        "@type": "ChemicalProperty",
        "hasDimension": "http://data.agrimetrics.co.uk/dimensions/nitrogen-concentration",
        "hasUnit": "http://data.agrimetrics.co.uk/units/milligram-per-kilogram",
        "value": 0.22300905
      },
      "hasBiologicalProperty": {
        "@type": "BiologicalProperty",
        "hasDimension": "http://data.agrimetrics.co.uk/dimensions/shannon-diversity-index",
        "hasUnit": "http://data.agrimetrics.co.uk/units/shannon-diversity-index",
        "value": 3.944604446
      }
    }
  ],
  "hasPriorityHabitat": [
    {
      "@type": "PriorityHabitat",
      "hasHabitatType": {
        "@type": "HabitatType",
        "@id": "http://data.agrimetrics.co.uk/habitat-types/ZLY3wdDReJIq8n",
        "preferredLabel": "Deciduous woodland"
      },
      "hasArea": {
        "@type": "Area",
        "unit": "http://data.agrimetrics.co.uk/units/square-metres",
        "value": 1217
      }
    }
  ],
  "hasWaterCatchment": [
    {
      "@type": "WaterCatchment",
      "isDrinkingWaterProtectedArea": false,
      "isInHabitatProtectedArea": false,
      "isInWildBirdsProtectedArea": false,
      "isNitrateVulnerableZone": false,
      "isShellfishProtectedArea": false,
      "isUrbanWasteWaterSensitiveArea": false,
      "hasWaterBodyType": "http://data.agrimetrics.co.uk/water-body-types/river",
      "hasWaterBodyClassificationItem": {
        "@type": "WaterBodyClassificationItem",
        "hasWaterBodyClassificationType": "http://data.agrimetrics.co.uk/water-body-classification-types/dissolved-oxygen",
        "hasWaterBodyClassification": "http://data.agrimetrics.co.uk/water-body-classifications/moderate",
        "hasWaterBodyClassificationCycle": "http://data.agrimetrics.co.uk/water-body-classification-cycles/cycle2-2015"
      }
    }
  ]
}
{
  "type": "object",
  "properties": {
    "_links": {
      "type": "object",
      "description": "HAL links to other Field APIs for this field.",
      "properties": {
        "ag:api:field-trends": {
          "type": "object",
          "description": "Link to Field Trends information for this field.",
          "properties": {
            "href": {
              "type": "string",
              "format": "uri",
              "example": "https://api.agrimetrics.co.uk/field-trends/FIELD_ID"
            }
          }
        },
        "ag:api:field-forecasts": {
          "type": "object",
          "description": "Link to Field Forecasts information for this field.",
          "properties": {
            "href": {
              "type": "string",
              "format": "uri",
              "example": "https://api.agrimetrics.co.uk/field-forecasts/FIELD_ID"
            }
          }
        },
        "self": {
          "type": "object",
          "properties": {
            "href": {
              "type": "string",
              "format": "uri",
              "example": "https://api.agrimetrics.co.uk/field-facts/FIELD_ID"
            }
          }
        }
      }
    },
    "@context": {
      "type": "string",
      "description": "Field Facts JSON-LD context",
      "format": "url",
      "example": "https://api.agrimetrics.co.uk/field-facts/context"
    },
    "@id": {
      "type": "string",
      "description": "Unique identifier for this field, assigned by Agrimetrics.",
      "format": "url",
      "example": "https://data.agrimetrics.co.uk/fields/FIELD_ID"
    },
    "hasLongTermAverageMonthlyMinimumTemperature": {
      "type": "object",
      "description": "Monthly average of the per-day minimum temperature values across a 10-year period.  Specified by month (1-12).",
      "properties": {
        "@type": {
          "type": "string",
          "description": "Ontology type.",
          "example": "Dataseries"
        },
        "hasDimension": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries dimension (minimum temperature).",
          "example": "http://data.agrimetrics.co.uk/dimensions/min-temperature"
        },
        "hasFrequency": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries frequency (monthly).",
          "example": "http://data.agrimetrics.co.uk/frequencies/monthly"
        },
        "hasUnit": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries unit (degrees Celsius).",
          "example": "http://data.agrimetrics.co.uk/units/celsius"
        },
        "hasDatapoint": {
          "type": "array",
          "description": "All datapoints of the dataseries.",
          "items": {
            "type": "object",
            "description": "Datapoint date and value.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "Datapoint"
              },
              "value": {
                "type": "number",
                "description": "Monthly long-term average minimum temperature",
                "example": -0.3
              },
              "month": {
                "type": "number",
                "description": "Month of the datapoint (1-based).",
                "example": 12
              }
            }
          }
        }
      }
    },
    "hasLongTermAverageMonthlyMaximumTemperature": {
      "type": "object",
      "description": "Monthly average of the per-day maximum temperature values across a 10-year period.  Specified by month (1-12).",
      "properties": {
        "@type": {
          "type": "string",
          "description": "Ontology type.",
          "example": "Dataseries"
        },
        "hasDimension": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries dimension (maximum temperature).",
          "example": "http://data.agrimetrics.co.uk/dimensions/max-temperature"
        },
        "hasFrequency": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries frequency (monthly).",
          "example": "http://data.agrimetrics.co.uk/frequencies/monthly"
        },
        "hasUnit": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries unit (degrees Celsius).",
          "example": "http://data.agrimetrics.co.uk/units/celsius"
        },
        "hasDatapoint": {
          "type": "array",
          "description": "All datapoints of the dataseries.",
          "items": {
            "type": "object",
            "description": "Datapoint date and value.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "Datapoint"
              },
              "value": {
                "type": "number",
                "description": "Monthly long-term average maximum temperature",
                "example": 12.5
              },
              "month": {
                "type": "number",
                "description": "Month of the datapoint (1-based).",
                "example": 12
              }
            }
          }
        }
      }
    },
    "hasLongTermAverageMonthlyMeanTemperature": {
      "type": "object",
      "description": "Monthly average of the per-day average air temperature values across a 10-year period.  Specified by month (1-12).",
      "properties": {
        "@type": {
          "type": "string",
          "description": "Ontology type.",
          "example": "Dataseries"
        },
        "hasDimension": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries dimension (mean temperature).",
          "example": "http://data.agrimetrics.co.uk/dimensions/mean-temperature"
        },
        "hasFrequency": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries frequency (monthly).",
          "example": "http://data.agrimetrics.co.uk/frequencies/monthly"
        },
        "hasUnit": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries unit (degrees Celsius).",
          "example": "http://data.agrimetrics.co.uk/units/celsius"
        },
        "hasDatapoint": {
          "type": "array",
          "description": "All datapoints of the dataseries.",
          "items": {
            "type": "object",
            "description": "Datapoint date and value.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "Datapoint"
              },
              "value": {
                "type": "number",
                "description": "Monthly long-term average mean temperature",
                "example": 5.8
              },
              "month": {
                "type": "number",
                "description": "Month of the datapoint (1-based).",
                "example": 12
              }
            }
          }
        }
      }
    },
    "hasLongTermAverageMonthlyTotalRainfall": {
      "type": "object",
      "description": "Monthly average of the per-day total rainfall values across a 10-year period. Specified by month (1-12).",
      "properties": {
        "@type": {
          "type": "string",
          "description": "Ontology type.",
          "example": "Dataseries"
        },
        "hasDimension": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries dimension (rainfall).",
          "example": "http://data.agrimetrics.co.uk/dimensions/rainfall"
        },
        "hasFrequency": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries frequency (monthly).",
          "example": "http://data.agrimetrics.co.uk/frequencies/monthly"
        },
        "hasUnit": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries unit (millimetre).",
          "example": "http://data.agrimetrics.co.uk/units/millimetre"
        },
        "hasDatapoint": {
          "type": "array",
          "description": "All datapoints of the dataseries.",
          "items": {
            "type": "object",
            "description": "Datapoint date and value.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "Datapoint"
              },
              "value": {
                "type": "number",
                "description": "Monthly average rainfall",
                "example": 39.44
              },
              "month": {
                "type": "number",
                "description": "Month of the datapoint (1-based).",
                "example": 12
              }
            }
          }
        }
      }
    },
    "hasLongTermAverageMonthlyHoursOfSunshine": {
      "type": "object",
      "description": "Monthly average of the per-month total hours of sunshine values across a 10-year period. Specified by month (1-12).",
      "properties": {
        "@type": {
          "type": "string",
          "description": "Ontology type.",
          "example": "Dataseries"
        },
        "hasDimension": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries dimension (hours of sunshine).",
          "example": "http://data.agrimetrics.co.uk/dimensions/hours-of-sunshine"
        },
        "hasFrequency": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries frequency (monthly).",
          "example": "http://data.agrimetrics.co.uk/frequencies/monthly"
        },
        "hasUnit": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries unit (hours).",
          "example": "http://data.agrimetrics.co.uk/units/hours"
        },
        "hasDatapoint": {
          "type": "array",
          "description": "All datapoints of the dataseries.",
          "items": {
            "type": "object",
            "description": "Datapoint date and value.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "Datapoint"
              },
              "value": {
                "type": "number",
                "description": "Monthly average hours of sunshine",
                "example": 10.44
              },
              "month": {
                "type": "number",
                "description": "Month of the datapoint (1-based).",
                "example": 12
              }
            }
          }
        }
      }
    },
    "hasLongTermAverageMonthlyDaysOfRainfallAbove1mm": {
      "type": "object",
      "description": "Monthly average of the per-month total days of rainfall above 1mm values across a 10-year period. Specified by month (1-12).",
      "properties": {
        "@type": {
          "type": "string",
          "description": "Ontology type.",
          "example": "Dataseries"
        },
        "hasDimension": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries dimension (days of rainfall above 1mm).",
          "example": "http://data.agrimetrics.co.uk/dimensions/days-of-rainfall-above-1mm"
        },
        "hasFrequency": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries frequency (monthly).",
          "example": "http://data.agrimetrics.co.uk/frequencies/monthly"
        },
        "hasUnit": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries unit (days).",
          "example": "http://data.agrimetrics.co.uk/units/days"
        },
        "hasDatapoint": {
          "type": "array",
          "description": "All datapoints of the dataseries.",
          "items": {
            "type": "object",
            "description": "Datapoint date and value.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "Datapoint"
              },
              "value": {
                "type": "number",
                "description": "Monthly average days of rainfall above 1mm",
                "example": 12.5
              },
              "month": {
                "type": "number",
                "description": "Month of the datapoint (1-based).",
                "example": 12
              }
            }
          }
        }
      }
    },
    "hasLongTermAverageMonthlyDaysOfRainfallAbove10mm": {
      "type": "object",
      "description": "Monthly average of the per-month total days of rainfall above 10mm values across a 10-year period. Specified by month (1-12).",
      "properties": {
        "@type": {
          "type": "string",
          "description": "Ontology type.",
          "example": "Dataseries"
        },
        "hasDimension": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries dimension (days of rainfall above 10mm).",
          "example": "http://data.agrimetrics.co.uk/dimensions/days-of-rainfall-above-10mm"
        },
        "hasFrequency": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries frequency (monthly).",
          "example": "http://data.agrimetrics.co.uk/frequencies/monthly"
        },
        "hasUnit": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries unit (days).",
          "example": "http://data.agrimetrics.co.uk/units/days"
        },
        "hasDatapoint": {
          "type": "array",
          "description": "All datapoints of the dataseries.",
          "items": {
            "type": "object",
            "description": "Datapoint date and value.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "Datapoint"
              },
              "value": {
                "type": "number",
                "description": "Monthly average days of rainfall above 1mm",
                "example": 5.5
              },
              "month": {
                "type": "number",
                "description": "Month of the datapoint (1-based).",
                "example": 12
              }
            }
          }
        }
      }
    },
    "hasLongTermAverageMonthlyDaysOfAirFrost": {
      "type": "object",
      "description": "Monthly average of the per-month total days of air-frost values across a 10-year period. Specified by month (1-12).",
      "properties": {
        "@type": {
          "type": "string",
          "description": "Ontology type.",
          "example": "Dataseries"
        },
        "hasDimension": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries dimension (days of air frost).",
          "example": "http://data.agrimetrics.co.uk/dimensions/days-of-air-frost"
        },
        "hasFrequency": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries frequency (monthly).",
          "example": "http://data.agrimetrics.co.uk/frequencies/monthly"
        },
        "hasUnit": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries unit (days).",
          "example": "http://data.agrimetrics.co.uk/units/days"
        },
        "hasDatapoint": {
          "type": "array",
          "description": "All datapoints of the dataseries.",
          "items": {
            "type": "object",
            "description": "Datapoint date and value.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "Datapoint"
              },
              "value": {
                "type": "number",
                "description": "Monthly average days of air frost",
                "example": 17.5
              },
              "month": {
                "type": "number",
                "description": "Month of the datapoint (1-based).",
                "example": 12
              }
            }
          }
        }
      }
    },
    "hasLongTermAverageMonthlyDaysOfGroundFrost": {
      "type": "object",
      "description": "Monthly average of the per-month total days of ground-frost values across a 10-year period. Specified by month (1-12).",
      "properties": {
        "@type": {
          "type": "string",
          "description": "Ontology type.",
          "example": "Dataseries"
        },
        "hasDimension": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries dimension (days of ground frost).",
          "example": "http://data.agrimetrics.co.uk/dimensions/days-of-ground-frost"
        },
        "hasFrequency": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries frequency (monthly).",
          "example": "http://data.agrimetrics.co.uk/frequencies/monthly"
        },
        "hasUnit": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries unit (days).",
          "example": "http://data.agrimetrics.co.uk/units/days"
        },
        "hasDatapoint": {
          "type": "array",
          "description": "All datapoints of the dataseries.",
          "items": {
            "type": "object",
            "description": "Datapoint date and value.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "Datapoint"
              },
              "value": {
                "type": "number",
                "description": "Monthly average days of ground frost",
                "example": 21.8
              },
              "month": {
                "type": "number",
                "description": "Month of the datapoint (1-based).",
                "example": 12
              }
            }
          }
        }
      }
    },
    "hasLongTermAverageMonthlyGrowingDegreeDays": {
      "type": "object",
      "description": "Monthly average of the per-month sum of growing degree days across a 10-year period. Specified by month (1-12).",
      "properties": {
        "@type": {
          "type": "string",
          "description": "Ontology type.",
          "example": "Dataseries"
        },
        "hasDimension": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries dimension (growing degree days).",
          "example": "http://data.agrimetrics.co.uk/dimensions/growing-degree-days"
        },
        "hasFrequency": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries frequency (monthly).",
          "example": "http://data.agrimetrics.co.uk/frequencies/monthly"
        },
        "hasUnit": {
          "type": "string",
          "format": "uri",
          "description": "Dataseries unit (days).",
          "example": "http://data.agrimetrics.co.uk/units/degree-days"
        },
        "hasDatapoint": {
          "type": "array",
          "description": "All datapoints of the dataseries.",
          "items": {
            "type": "object",
            "description": "Datapoint date and value.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "Datapoint"
              },
              "value": {
                "type": "number",
                "description": "Monthly sum of growing degree days.",
                "example": 21.8
              },
              "month": {
                "type": "number",
                "description": "Month of the datapoint (1-based).",
                "example": 12
              }
            }
          }
        }
      }
    },
    "hasRepresentativePoint": {
      "type": "object",
      "description": "The representative point for a field.",
      "properties": {
        "@type": {
          "type": "string",
          "description": "Ontology type.",
          "example": "Point"
        },
        "altitude": {
          "type": "number",
          "description": "Altitude of the representative point in metres.",
          "example": 134
        }
      }
    },
    "hasSoilLayer": {
      "type": "array",
      "description": "Soil information for topsoil and subsoil layers.  Soil texture is available for both layers; additional chemical and biological parameters are available for topsoil.",
      "items": {
        "type": "object",
        "description": "Soil layer.",
        "properties": {
          "@type": {
            "type": "string",
            "description": "Ontology type.",
            "example": "SoilLayer"
          },
          "hasSoilLayerType": {
            "type": "string",
            "format": "uri",
            "description": "Identifies which layer of the soil this data relates to.",
            "example": "http://data.agrimetrics.co.uk/soil-layer-types/topsoil"
          },
          "hasSoilTexture": {
            "type": "object",
            "description": "Soil texture for the layer.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "SoilTexture"
              },
              "hasSoilTextureType": {
                "type": "string",
                "format": "uri",
                "description": "Soil texture according to particle size distribution (proportions of clay, silt and sand) using the USDA definitions for particle sizes (50µm as threshold between silt and sand) and resulting soil texture according to the proportions.  Note that this results in different classification to the prevalent UK system as described in Natural England Technical Information Note TIN037 and others.  Soil texture for topsoil is based on a 0-30cm sampling range, and subsoil 30-90cm.",
                "example": "http://data.agrimetrics.co.uk/soil-texture-types/sandy-clay-loam"
              },
              "sandPercentage": {
                "type": "number",
                "description": "Percentage that is sand.",
                "example": 32.5
              },
              "clayPercentage": {
                "type": "number",
                "description": "Percentage that is clay.",
                "example": 46.2
              },
              "siltPercentage": {
                "type": "number",
                "description": "Percentage that is silt.",
                "example": 21.3
              }
            }
          },
          "hasChemicalProperty": {
            "type": "object",
            "description": "A Chemical property of the soil.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "ChemicalProperty"
              },
              "hasDimension": {
                "type": "string",
                "format": "uri",
                "description": "The dimension of the chemical property.",
                "example": "http://data.agrimetrics.co.uk/dimensions/nitrogen-concentration"
              },
              "hasUnit": {
                "type": "string",
                "format": "uri",
                "description": "The unit of the chemical property.",
                "example": "http://data.agrimetrics.co.uk/units/milligram-per-kilogram"
              },
              "value": {
                "type": "number",
                "description": "The value of the chemical property.",
                "example": 0.22300905
              }
            }
          },
          "hasBiologicalProperty": {
            "type": "object",
            "description": "A biological property of the soil.  Note - some parameters are averages of multiple samples, and may be interpolated between gridpoints.  These result in counts that are not whole numbers.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "BiologicalProperty"
              },
              "hasDimension": {
                "type": "string",
                "format": "uri",
                "description": "The dimension of the biological property.",
                "example": "http://data.agrimetrics.co.uk/dimensions/shannon-diversity-index"
              },
              "hasUnit": {
                "type": "string",
                "format": "uri",
                "description": "The unit for the biological property.",
                "example": "http://data.agrimetrics.co.uk/units/shannon-diversity-index"
              },
              "value": {
                "type": "number",
                "description": "The value of the biological property.",
                "example": 3.944604446
              }
            }
          }
        }
      }
    },
    "hasPriorityHabitat": {
      "type": "array",
      "description": "The priority habitats that are within the field, intersect with the field or are within 100m of the boundary of the field.",
      "items": {
        "type": "object",
        "description": "Priority Habitat.",
        "properties": {
          "@type": {
            "type": "string",
            "description": "Ontology type.",
            "example": "PriorityHabitat"
          },
          "hasHabitatType": {
            "type": "object",
            "description": "Habitat type.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "HabitatType"
              },
              "@id": {
                "type": "string",
                "format": "uri",
                "description": "The unique URI for the priority habitat type.",
                "example": "http://data.agrimetrics.co.uk/habitat-types/ZLY3wdDReJIq8n"
              },
              "preferredLabel": {
                "type": "string",
                "description": "Common name of priority habitat type.",
                "example": "Deciduous woodland"
              }
            }
          },
          "hasArea": {
            "type": "object",
            "description": "Total area of the priority habitat.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "Area"
              },
              "unit": {
                "type": "string",
                "format": "uri",
                "description": "The unit of area.",
                "example": "http://data.agrimetrics.co.uk/units/square-metres"
              },
              "value": {
                "type": "number",
                "description": "The area of priority habitat.",
                "example": 1217
              }
            }
          }
        }
      }
    },
    "hasWaterCatchment": {
      "type": "array",
      "description": "The water catchment that intersect with the field.  Typically this will be the water catchment that the field drains into.",
      "items": {
        "type": "object",
        "description": "Water catchment.",
        "properties": {
          "@type": {
            "type": "string",
            "description": "Ontology type.",
            "example": "WaterCatchment"
          },
          "isDrinkingWaterProtectedArea": {
            "type": "boolean",
            "description": "Whether or not the water catchment is in a drinking water protected area, as defined in the EU Drinking Water Directive and the wider EU Water Framework Directive.",
            "example": false
          },
          "isInHabitatProtectedArea": {
            "type": "boolean",
            "description": "Whether or not the water catchment intersects with one or more Sites of Community Importance for a core specied protected under the EU Habitats Directive.",
            "example": false
          },
          "isInWildBirdsProtectedArea": {
            "type": "boolean",
            "description": "Whether or not the water catchment intersects with a Special Protection Area under the EU Birds Directive (which also form part of the Special Areas of Conservation registered under the EU Habitats Directive).",
            "example": false
          },
          "isNitrateVulnerableZone": {
            "type": "boolean",
            "description": "Whether or not the water catchment is identified as a Nitrate Vulnerable Zone under the EU Nitrates Directive.",
            "example": false
          },
          "isShellfishProtectedArea": {
            "type": "boolean",
            "description": "Whether or not the water catchment is identified as a protected area as shellfish designated waters under the EU Water Framework Directive.",
            "example": false
          },
          "isUrbanWasteWaterSensitiveArea": {
            "type": "boolean",
            "description": "Whether or not the water catchment is identified as a sensitive area under the EU Urban Waste Water Treatment Directive.",
            "example": false
          },
          "hasWaterBodyType": {
            "type": "string",
            "format": "url",
            "description": "Type of water body in the catchment.",
            "example": "http://data.agrimetrics.co.uk/water-body-types/river"
          },
          "hasWaterBodyClassificationItem": {
            "type": "object",
            "description": "Water catchment classification item, identifying one of several potential classifications for this water catchment as identified under a particular classification cycle for the EU Water Framework Directive.",
            "properties": {
              "@type": {
                "type": "string",
                "description": "Ontology type.",
                "example": "WaterBodyClassificationItem"
              },
              "hasWaterBodyClassificationType": {
                "type": "string",
                "format": "uri",
                "description": "Water body classification type.",
                "example": "http://data.agrimetrics.co.uk/water-body-classification-types/dissolved-oxygen"
              },
              "hasWaterBodyClassification": {
                "type": "string",
                "format": "uri",
                "description": "Water body classification.",
                "example": "http://data.agrimetrics.co.uk/water-body-classifications/moderate"
              },
              "hasWaterBodyClassificationCycle": {
                "type": "string",
                "format": "uri",
                "description": "Water body classification cycle.",
                "example": "http://data.agrimetrics.co.uk/water-body-classification-cycles/cycle2-2015"
              }
            }
          }
        }
      }
    }
  }
}

400 Bad Request

Missing id parameter.

Representations

{
  "statusCode": 0.0,
  "message": "string"
}
{
  "type": "object",
  "properties": {
    "statusCode": {
      "type": "number",
      "description": "HTTP error code"
    },
    "message": {
      "type": "string",
      "description": "Developer friendly error message"
    }
  }
}

404 Not Found

No field with given identifier were found.

Representations

{
  "statusCode": 0.0,
  "message": "string"
}
{
  "type": "object",
  "properties": {
    "statusCode": {
      "type": "number",
      "description": "HTTP error code"
    },
    "message": {
      "type": "string",
      "description": "Developer friendly error message"
    }
  }
}

Code samples

@ECHO OFF

curl -v -X GET "https://api.agrimetrics.co.uk/field-facts/{id}"
-H "Ocp-Apim-Subscription-Key: {subscription key}"

--data-ascii "{body}" 
using System;
using System.Net.Http.Headers;
using System.Text;
using System.Net.Http;
using System.Web;

namespace CSHttpClientSample
{
    static class Program
    {
        static void Main()
        {
            MakeRequest();
            Console.WriteLine("Hit ENTER to exit...");
            Console.ReadLine();
        }
        
        static async void MakeRequest()
        {
            var client = new HttpClient();
            var queryString = HttpUtility.ParseQueryString(string.Empty);

            // Request headers
            client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", "{subscription key}");

            var uri = "https://api.agrimetrics.co.uk/field-facts/{id}?" + queryString;

            var response = await client.GetAsync(uri);
        }
    }
}	
// // This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
import java.net.URI;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class JavaSample 
{
    public static void main(String[] args) 
    {
        HttpClient httpclient = HttpClients.createDefault();

        try
        {
            URIBuilder builder = new URIBuilder("https://api.agrimetrics.co.uk/field-facts/{id}");


            URI uri = builder.build();
            HttpGet request = new HttpGet(uri);
            request.setHeader("Ocp-Apim-Subscription-Key", "{subscription key}");


            // Request body
            StringEntity reqEntity = new StringEntity("{body}");
            request.setEntity(reqEntity);

            HttpResponse response = httpclient.execute(request);
            HttpEntity entity = response.getEntity();

            if (entity != null) 
            {
                System.out.println(EntityUtils.toString(entity));
            }
        }
        catch (Exception e)
        {
            System.out.println(e.getMessage());
        }
    }
}

<!DOCTYPE html>
<html>
<head>
    <title>JSSample</title>
    <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquery.min.js"></script>
</head>
<body>

<script type="text/javascript">
    $(function() {
        var params = {
            // Request parameters
        };
      
        $.ajax({
            url: "https://api.agrimetrics.co.uk/field-facts/{id}?" + $.param(params),
            beforeSend: function(xhrObj){
                // Request headers
                xhrObj.setRequestHeader("Ocp-Apim-Subscription-Key","{subscription key}");
            },
            type: "GET",
            // Request body
            data: "{body}",
        })
        .done(function(data) {
            alert("success");
        })
        .fail(function() {
            alert("error");
        });
    });
</script>
</body>
</html>
#import <Foundation/Foundation.h>

int main(int argc, const char * argv[])
{
    NSAutoreleasePool * pool = [[NSAutoreleasePool alloc] init];
    
    NSString* path = @"https://api.agrimetrics.co.uk/field-facts/{id}";
    NSArray* array = @[
                         // Request parameters
                         @"entities=true",
                      ];
    
    NSString* string = [array componentsJoinedByString:@"&"];
    path = [path stringByAppendingFormat:@"?%@", string];

    NSLog(@"%@", path);

    NSMutableURLRequest* _request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:path]];
    [_request setHTTPMethod:@"GET"];
    // Request headers
    [_request setValue:@"{subscription key}" forHTTPHeaderField:@"Ocp-Apim-Subscription-Key"];
    // Request body
    [_request setHTTPBody:[@"{body}" dataUsingEncoding:NSUTF8StringEncoding]];
    
    NSURLResponse *response = nil;
    NSError *error = nil;
    NSData* _connectionData = [NSURLConnection sendSynchronousRequest:_request returningResponse:&response error:&error];

    if (nil != error)
    {
        NSLog(@"Error: %@", error);
    }
    else
    {
        NSError* error = nil;
        NSMutableDictionary* json = nil;
        NSString* dataString = [[NSString alloc] initWithData:_connectionData encoding:NSUTF8StringEncoding];
        NSLog(@"%@", dataString);
        
        if (nil != _connectionData)
        {
            json = [NSJSONSerialization JSONObjectWithData:_connectionData options:NSJSONReadingMutableContainers error:&error];
        }
        
        if (error || !json)
        {
            NSLog(@"Could not parse loaded json with error:%@", error);
        }
        
        NSLog(@"%@", json);
        _connectionData = nil;
    }
    
    [pool drain];

    return 0;
}
<?php
// This sample uses the Apache HTTP client from HTTP Components (http://hc.apache.org/httpcomponents-client-ga/)
require_once 'HTTP/Request2.php';

$request = new Http_Request2('https://api.agrimetrics.co.uk/field-facts/{id}');
$url = $request->getUrl();

$headers = array(
    // Request headers
    'Ocp-Apim-Subscription-Key' => '{subscription key}',
);

$request->setHeader($headers);

$parameters = array(
    // Request parameters
);

$url->setQueryVariables($parameters);

$request->setMethod(HTTP_Request2::METHOD_GET);

// Request body
$request->setBody("{body}");

try
{
    $response = $request->send();
    echo $response->getBody();
}
catch (HttpException $ex)
{
    echo $ex;
}

?>
########### Python 2.7 #############
import httplib, urllib, base64

headers = {
    # Request headers
    'Ocp-Apim-Subscription-Key': '{subscription key}',
}

params = urllib.urlencode({
})

try:
    conn = httplib.HTTPSConnection('api.agrimetrics.co.uk')
    conn.request("GET", "/field-facts/{id}?%s" % params, "{body}", headers)
    response = conn.getresponse()
    data = response.read()
    print(data)
    conn.close()
except Exception as e:
    print("[Errno {0}] {1}".format(e.errno, e.strerror))

####################################

########### Python 3.2 #############
import http.client, urllib.request, urllib.parse, urllib.error, base64

headers = {
    # Request headers
    'Ocp-Apim-Subscription-Key': '{subscription key}',
}

params = urllib.parse.urlencode({
})

try:
    conn = http.client.HTTPSConnection('api.agrimetrics.co.uk')
    conn.request("GET", "/field-facts/{id}?%s" % params, "{body}", headers)
    response = conn.getresponse()
    data = response.read()
    print(data)
    conn.close()
except Exception as e:
    print("[Errno {0}] {1}".format(e.errno, e.strerror))

####################################
require 'net/http'

uri = URI('https://api.agrimetrics.co.uk/field-facts/{id}')


request = Net::HTTP::Get.new(uri.request_uri)
# Request headers
request['Ocp-Apim-Subscription-Key'] = '{subscription key}'
# Request body
request.body = "{body}"

response = Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
    http.request(request)
end

puts response.body