Data Types
The Agrograph REST API provides two distinct types of data:
-
Static data - the data does not change over the course of time. Extraction of static data is triggered by setting
"static": true
in the input payload. The static flag defaults tofalse
if not specified. -
Annual data - the data differs over time. Extraction of annual data is on by default and can be turned off by setting
"annual": false
in the input payload.
Additionally, some APIs are crop specific and different crop parameters in the input will result in different data returned. The crop specificity of each of the variable is indicated in the table below. The crop selection for extraction process is controlled by the crop
parameter in the input payload (e.g., "crop": "corn"
will trigger extraction of corn-specific data).
The breakdown of data between static and annual category is shown in the table below:
ENDPOINT | ANNUAL DATA | STATIC DATA | CROP SPECIFIC? |
---|---|---|---|
/land | landCover, majorityCropType, tillableFraction, forestFraction, waterFraction,buildings | elevation, slope, topoComplexity, topoWetness, soilTexture, aws, soc, spi, floodplain | NO |
/production | cropYield, temporalVolatility, spatialVolatility | YES | |
/management | irrigation, tillage, cropResidue | NO | |
/risk | agrisk | floodRisk, droughtRisk | NO |
/sustainability | conservation, irrigationAmount, rotation, diversity | NO |