Research PH, Magnesium, and phosphorus in a “tropical lowland semi-arid” Agroecological zone in Tanzania
Use case summary
A digital agronomist is seeking access to soil data specific to pH, magnesium, and phosphorus levels in one of Tanzania's "tropical highland sub-humid" agroecological zones. Hi focus is to find point data collected over the past 20 years in this particular region and download it for further analysis.
Location of interest
POLYGON ((36.362 -3.246095, 36.999207 -3.200848, 37.040405 -3.538093, 36.390839 -3.57236, 36.362 -3.246095))
Steps
Step 1 : Call the POST operation of the Spatial Filters endpoint to see what is available in his area of interest
curl --request POST \
--url https://api.varda.ag/soilhive/v1/spatial-filters/queries \
--header 'accept: application/ld+json' \
--header 'authorization: Bearer {access-token}' \
--header 'content-type: application/json' \
--data '
{
"areaOfInterest": "POLYGON ((36.362 -3.246095, 36.999207 -3.200848, 37.040405 -3.538093, 36.390839 -3.57236, 36.362 -3.246095)) "
}
{
"@context": "https://api.varda.ag/soilhive/v1/core.jsonld",
"id": "https://api.varda.ag/soilhive/v1/spatial-filters",
"type": "ItemList",
"description": "List of spatial filters",
"items": {
"id": "https://api.varda.ag/soilhive/v1/spatial-filters",
"type": "ItemList",
"description": "List of spatial filters",
"items": [
{
"type": "SoilGroupsFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/141",
"identifier": 141,
"name": "Andosols",
"description": "Young soils formed from volcanic deposits."
},
{
"type": "LandCoverFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/133",
"identifier": 133,
"name": "Bare sparse vegetation",
"description": "Lands with exposed soil, sand, or rocks and never has more than 10 % vegetated cover during any time of the year"
},
{
"type": "LandCoverFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/120",
"identifier": 120,
"name": "Closed forest deciduous broad leaf",
"description": "Tree canopy >70 %, consists of seasonal broadleaf tree communities with an annual cycle of leaf-on and leaf-off periods."
},
{
"type": "LandCoverFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/119",
"identifier": 119,
"name": "Closed forest evergreen, broad leaf",
"description": "Tree canopy >70 %, almost all broadleaf trees remain green year round. Canopy is never without green foliage."
},
{
"type": "LandCoverFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/134",
"identifier": 134,
"name": "Cultivated and managed vegetation agriculture (cropland)",
"description": "Lands covered with temporary crops followed by harvest and a bare soil period (e.g., single and multiple cropping systems). Note that perennial woody crops will be classified as the appropriate forest or shrub land cover type."
},
{
"type": "AgroecologicalZonesFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/52",
"identifier": 52,
"name": "Dominantly very steep terrain",
"description": "Areas with very steep terrain where the sum of percentages of slope classes SLP7 (30–45%) and SLP8 (slope > 45%) exceeds in a grid cell a given target threshold (e.g. 75%) and the sum of slope classes SLP1 to SLP4 (i.e., terrain slopes ≤ 8%) is less than a maximum threshold;"
},
{
"type": "LandCoverFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/130",
"identifier": 130,
"name": "Herbaceous vegetation",
"description": "Plants without persistent stem or shoots above ground and lacking definite firm structure. Tree and shrub cover is less than 10 %."
},
{
"type": "LandCoverFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/131",
"identifier": 131,
"name": "Herbaceous wetland",
"description": "Lands with a permanent mixture of water and herbaceous or woody vegetation. The vegetation can be present in either salt, brackish, or fresh water."
},
{
"type": "AgroecologicalZonesFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/54",
"identifier": 54,
"name": "Land with ample irrigated soils",
"description": "Irrigated areas where the share of irrigated cropland in a grid cell exceeds a specified minimum threshold (e.g., 20% of a 30 arc-second grid cell) or where cropland exceeds a given minimum threshold (e.g. 40% of a 30 arc-second grid cell) and at least half of the cropland in a pixel is equipped for irrigation."
},
{
"type": "AgroecologicalZonesFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/53",
"identifier": 53,
"name": "Land with severe soil terrain limitations",
"description": "Areas with severe and very severe soil/terrain limitations and so-called miscellaneous units of the soil database (e.g. rock outcrops, sand dunes, glaciers, etc.)."
},
{
"type": "SoilGroupsFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/155",
"identifier": 155,
"name": "Leptosols",
"description": "Very shallow soils over hard rock or in unconsolidated gravelly material."
},
{
"type": "SoilGroupsFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/156",
"identifier": 156,
"name": "Luvisols",
"description": "Soils with subsurface accumulation of high activity clays and high base saturation."
},
{
"type": "LandCoverFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/126",
"identifier": 126,
"name": "Open forest deciduous broad leaf",
"description": "Top layer- trees 15-70 % and second layer- mixed of shrubs and grassland, consists of seasonal broadleaf tree communities with an annual cycle of leaf-on and leaf-off periods."
},
{
"type": "LandCoverFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/125",
"identifier": 125,
"name": "Open forest evergreen broad leaf",
"description": "Top layer- trees 15-70 % and second layer- mixed of shrubs and grassland, almost all broadleaf trees remain green year round. Canopy is never without green foliage."
},
{
"type": "LandCoverFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/129",
"identifier": 129,
"name": "Shrubs",
"description": "These are woody perennial plants with persistent and woody stems and without any defined main stem being less than 5 m tall. The shrub foliage can be either evergreen or deciduous."
},
{
"type": "SoilGroupsFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/168",
"identifier": 168,
"name": "Technosols",
"description": "Soils having properties and pedogenesis dominated by human activities and containing human-made materials."
},
{
"type": "AgroecologicalZonesFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/32",
"identifier": 32,
"name": "Tropical highland sub-humid",
"description": "Areas with monthly mean temperatures, corrected to sea level, above 20°C. Length of Growing period between 180 to 270 days."
},
{
"type": "AgroecologicalZonesFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/29",
"identifier": 29,
"name": "Tropical lowland sub-humid",
"description": "Areas with monthly mean temperatures, corrected to sea level, above 20°C. Length of Growing period between 180 to 270 days."
},
{
"type": "LandCoverFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/135",
"identifier": 135,
"name": "Urban built up",
"description": "Land covered by buildings and other man- made structures"
},
{
"type": "SoilGroupsFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/170",
"identifier": 170,
"name": "Vertisols",
"description": "Dark-colored cracking and shrink-swell clays."
}
]
}
}
Tropical Highland Sub-Humid is available in his location of interest with ID=32
"type": "AgroecologicalZonesFilter",
"id": "/soilhive/v1/resource-catalog/spatial-filters/32",
"identifier": 32,
"name": "Tropical highland sub-humid",
"description": "Areas with monthly mean temperatures, corrected to sea level, above 20°C. Length of Growing period between 180 to 270 days."
Step 2 : Call the POST operation of the Soil Properties endpoint to discover which soil properties are available in this area of interest
curl --request POST \
--url https://api.varda.ag/soilhive/v1/soil-properties/queries \
--header 'accept: application/ld+json' \
--header 'authorization: Bearer {access-token}' \
--header 'content-type: application/json' \
--data '
{
"areaOfInterest": "POLYGON ((36.362 -3.246095, 36.999207 -3.200848, 37.040405 -3.538093, 36.390839 -3.57236, 36.362 -3.246095)) ",
"spatialFilters": [32]
}'
{
"@context": "https://api.varda.ag/soilhive/v1/core.jsonld",
"id": "https://api.varda.ag/soilhive/v1/soil-properties",
"type": "ItemList",
"description": "List of soil properties",
"items": {
"id": "https://api.varda.ag/soilhive/v1/soil-properties",
"type": "ItemList",
"description": "List of soil properties",
"items": [
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/6",
"identifier": 6,
"name": "Aluminium",
"unitText": "mg/kg, ppm",
"unitCode": "https://qudt.org/vocab/unit/MilliGM-PER-KiloGM, https://qudt.org/vocab/unit/PPM"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/42",
"identifier": 42,
"name": "Base Saturation",
"description": "The base saturation measures the sum of exchangeable cations (nutrients) Na+, Ca++, Mg++ and K+ as a percentage of the overall exchange capacity of the soil (including the same cations plus H+ and Al+++). The value often shows a near linear correlation with pH. Data are derived directly from the WISE30sec database. ( % of CECsoil)",
"unitText": "mmolc/dm3",
"unitCode": "mmolc/dm3"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/19",
"identifier": 19,
"name": "Boron",
"unitText": "mg/kg, ppm, 100ppm",
"unitCode": "https://qudt.org/vocab/unit/MilliGM-PER-KiloGM, https://qudt.org/vocab/unit/PPM, 100ppm"
},
{
"type": "PhysicalProperty",
"id": "/soilhive/v1/soil-properties/13",
"identifier": 13,
"name": "Bulk Density",
"unitText": "10xkg/m3, cg/cm3, kg/dm3, kg/m3",
"unitCode": "10xkg/m3, cg/cm3, https://qudt.org/vocab/unit/KiloGM-PER-DeciM3, kg/m3"
},
{
"type": "BiologicalProperty",
"id": "/soilhive/v1/soil-properties/43",
"identifier": 43,
"name": "C:N Ratio",
"description": "A carbon-to-nitrogen ratio is a ratio of the mass of carbon to the mass of nitrogen in soil material. The C:N ratio is a key indicator as it describes a balance between energetic foods (represented by carbon) and material to build protein with (represented by nitrogen). An optimal C:N ratio of around 24:1 provides for higher microbial activity (USDA, 2011). Data are directly derived from WISE30sec. Note that C/N ratios have been calculated as is from the measured data (CNrt), not as the ratio of the derived values for C and N, ditto for CECclay, as this would introduce additional errors."
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/30",
"identifier": 30,
"name": "Calcium",
"unitText": "mg/kg, ppm",
"unitCode": "https://qudt.org/vocab/unit/MilliGM-PER-KiloGM, https://qudt.org/vocab/unit/PPM"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/8",
"identifier": 8,
"name": "Calcium Carbonate",
"unitText": "g/kg",
"unitCode": "https://qudt.org/vocab/unit/GM-PER-KiloGM"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/9",
"identifier": 9,
"name": "Cation Exchange Capacity",
"unitText": "mmolc/kg, cmolc/kg, cmol(+)/kg",
"unitCode": "mmolc/kg, cmolc/kg, cmol(+)/kg"
},
{
"type": "PhysicalProperty",
"id": "/soilhive/v1/soil-properties/10",
"identifier": 10,
"name": "Clay",
"unitText": "g/kg, g/100g, %",
"unitCode": "https://qudt.org/vocab/unit/GM-PER-KiloGM, g/100g, https://qudt.org/vocab/unit/PERCENT"
},
{
"type": "PhysicalProperty",
"id": "/soilhive/v1/soil-properties/14",
"identifier": 14,
"name": "Coarse Fragments",
"unitText": "g/100g, %",
"unitCode": "g/100g, https://qudt.org/vocab/unit/PERCENT"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/20",
"identifier": 20,
"name": "Copper",
"unitText": "mg/kg, ppm, 100ppm",
"unitCode": "https://qudt.org/vocab/unit/MilliGM-PER-KiloGM, https://qudt.org/vocab/unit/PPM, 100ppm"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/2",
"identifier": 2,
"name": "Electrical Conductivity",
"unitText": "dS/m, mS/m",
"unitCode": "https://qudt.org/vocab/unit/DeciS-PER-M, https://qudt.org/vocab/unit/MilliS-PER-M"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/29",
"identifier": 29,
"name": "Exchangeable acidity",
"unitText": "cmol/kg",
"unitCode": "https://qudt.org/vocab/unit/CentiMOL-PER-KiloGM"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/24",
"identifier": 24,
"name": "Extractable Bases",
"unitText": "cmolc/kg",
"unitCode": "cmolc/kg"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/44",
"identifier": 44,
"name": "gypsum",
"description": "Gypsum is a chemical compound (a salt) which occurs occasionally in soils particularly in the driest areas of the globe where it can occur in a flower-like form typically opaque with embedded sand grains called desert rose. In soils it may occur in fibers, crystals or soft. Data are derived directly from the WISE30sec database."
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/7",
"identifier": 7,
"name": "Iron",
"unitText": "mg/kg, ppm, 100ppm",
"unitCode": "https://qudt.org/vocab/unit/MilliGM-PER-KiloGM, https://qudt.org/vocab/unit/PPM, 100ppm"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/31",
"identifier": 31,
"name": "Magnesium",
"unitText": "mg/kg, ppm",
"unitCode": "https://qudt.org/vocab/unit/MilliGM-PER-KiloGM, https://qudt.org/vocab/unit/PPM"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/21",
"identifier": 21,
"name": "Manganese",
"unitText": "mg/kg, ppm, 100ppm",
"unitCode": "https://qudt.org/vocab/unit/MilliGM-PER-KiloGM, https://qudt.org/vocab/unit/PPM, 100ppm"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/3",
"identifier": 3,
"name": "Nitrogen",
"unitText": "cg/kg, g/kg, %, %w",
"unitCode": "cg/kg, https://qudt.org/vocab/unit/GM-PER-KiloGM, https://qudt.org/vocab/unit/PERCENT, https://qudt.org/vocab/unit/PERCENT"
},
{
"type": "BiologicalProperty",
"id": "/soilhive/v1/soil-properties/15",
"identifier": 15,
"name": "Organic Carbon Content",
"unitText": "dg/kg, g/kg, %",
"unitCode": "dg/kg, https://qudt.org/vocab/unit/GM-PER-KiloGM, https://qudt.org/vocab/unit/PERCENT"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/1",
"identifier": 1,
"name": "pH",
"unitText": "pHx10",
"unitCode": "pHx10"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/4",
"identifier": 4,
"name": "Phosphorus",
"unitText": "ppm, mg/kg, g/kg",
"unitCode": "https://qudt.org/vocab/unit/PPM, https://qudt.org/vocab/unit/MilliGM-PER-KiloGM, https://qudt.org/vocab/unit/GM-PER-KiloGM"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/5",
"identifier": 5,
"name": "Potassium",
"unitText": "mg/kg, ppm",
"unitCode": "https://qudt.org/vocab/unit/MilliGM-PER-KiloGM, https://qudt.org/vocab/unit/PPM"
},
{
"type": "PhysicalProperty",
"id": "/soilhive/v1/soil-properties/62",
"identifier": 62,
"name": "Rock Horizon",
"unitText": "cm",
"unitCode": "https://qudt.org/vocab/unit/CentiM"
},
{
"type": "PhysicalProperty",
"id": "/soilhive/v1/soil-properties/12",
"identifier": 12,
"name": "Sand",
"unitText": "g/kg, g/100g, %",
"unitCode": "https://qudt.org/vocab/unit/GM-PER-KiloGM, g/100g, https://qudt.org/vocab/unit/PERCENT"
},
{
"type": "PhysicalProperty",
"id": "/soilhive/v1/soil-properties/11",
"identifier": 11,
"name": "Silt",
"unitText": "g/kg, g/100g, %",
"unitCode": "https://qudt.org/vocab/unit/GM-PER-KiloGM, g/100g, https://qudt.org/vocab/unit/PERCENT"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/28",
"identifier": 28,
"name": "Sodium",
"unitText": "mg/kg, ppm",
"unitCode": "https://qudt.org/vocab/unit/MilliGM-PER-KiloGM, https://qudt.org/vocab/unit/PPM"
},
{
"type": "DerivedProperty",
"id": "/soilhive/v1/soil-properties/33",
"identifier": 33,
"name": "Soil Organic Carbon Density",
"unitText": "hg/m3",
"unitCode": "hg/m3"
},
{
"type": "DerivedProperty",
"id": "/soilhive/v1/soil-properties/32",
"identifier": 32,
"name": "Soil Organic Carbon Stock",
"unitText": "t/ha",
"unitCode": "https://qudt.org/vocab/unit/TONNE-PER-HA"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/22",
"identifier": 22,
"name": "Sulfur",
"unitText": "ppm, mg/kg",
"unitCode": "https://qudt.org/vocab/unit/PPM, https://qudt.org/vocab/unit/MilliGM-PER-KiloGM"
},
{
"type": "PhysicalProperty",
"id": "/soilhive/v1/soil-properties/45",
"identifier": 45,
"name": "textural class",
"description": "USDA texture class name and code. Soil texture is a soil property used to describe the relative proportion of different grain sizes of mineral particles in a soil. Particles are grouped according to their size into what are called soil separates (clay, silt, and sand). The soil texture class (e.g. sand, clay, loam, etc.) corresponds to a particular range of separate fractions, and is diagrammatically represented by the soil texture triangle."
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/18",
"identifier": 18,
"name": "Total Carbon",
"unitText": "g/kg, %, %w",
"unitCode": "https://qudt.org/vocab/unit/GM-PER-KiloGM, https://qudt.org/vocab/unit/PERCENT, https://qudt.org/vocab/unit/PERCENT"
},
{
"type": "DerivedProperty",
"id": "/soilhive/v1/soil-properties/35",
"identifier": 35,
"name": "USDA Texture"
},
{
"type": "PhysicalProperty",
"id": "/soilhive/v1/soil-properties/34",
"identifier": 34,
"name": "Water Content",
"unitText": "cm3/100cm3",
"unitCode": "cm3/100cm3"
},
{
"type": "ChemicalProperty",
"id": "/soilhive/v1/soil-properties/23",
"identifier": 23,
"name": "Zinc",
"unitText": "mg/kg, ppm, 100ppm",
"unitCode": "https://qudt.org/vocab/unit/MilliGM-PER-KiloGM, https://qudt.org/vocab/unit/PPM, 100ppm"
}
]
}
}
Ph, Magnesium, and phosphorus are available in his area of interest and correspond with his spatial filter with IDS 1, 31, and 4.
Step 3 : Call the POST operation of the Data Sources endpoint to discover which data sources are available for the spatial filters, soil properties and area of interest
curl --request POST \
--url https://api.varda.ag/soilhive/v1/datasets/queries \
--header 'accept: application/ld+json' \
--header 'authorization: Bearer {access-token}' \
--header 'content-type: application/json' \
--data '
{
"areaOfInterest": "POLYGON ((36.362 -3.246095, 36.999207 -3.200848, 37.040405 -3.538093, 36.390839 -3.57236, 36.362 -3.246095))",
"spatialFilters": [32],
"soilProperties": [1,4,32]
}'
{
"@context": "https://api.varda.ag/soilhive/v1/core.jsonld",
"id": "https://api.varda.ag/soilhive/v1/datasets",
"type": "DataCatalog",
"description": "List of the available datasets in this data catalog",
"temporalCoverage": "1905/2019",
"DataSet": [
{
"type": "DataSet",
"id": "https://api.varda.ag/soilhive/v1/datasets/25",
"identifier": 25,
"name": "Africa SoilGrids nutrients",
"description": "The African Soil Information Service (AfSIS), managed by ISRIC – World Soil Information, is an initiative designed to enhance soil data and information across Sub-Saharan Africa. It aims to support sustainable land management and agricultural productivity by creating detailed soil maps and databases. AfSIS's data collection encompasses a diverse range of samples, including 18,000 specimens from 60 sentinel sites across Sub-Saharan Africa, covering soil depths from 0-20 cm and 20-50 cm. Additionally, the service has amassed 60,000 samples from 18,500 soil profiles distributed across 40 countries. This extensive dataset is further enriched by contributions from various sources such as EthioSIS, GhaSIS, NiSIS, IFDC, the One Acre Fund, the University of California, Davis, and VitalSigns, ensuring a robust and multifarious soil information system. AfSIS integrates remote sensing techniques, digital soil mapping, and geospatial data to produce detailed and actionable soil information. These technological tools enable the creation of soil maps and facilitate a better understanding of soil properties and their spatial distribution. The initiative was founded by Bill & Melinda Gates Foundation, with the support of the International Fund for Agricultural Development (IFAD), the World Bank, and the European Union.",
"url": "https://files.isric.org/public/af250m_nutrient/",
"measurementTechnique": {
"type": "DefinedTerm",
"name": "D2.8.III.3 INSPIRE Data Specification on Soil, soil profile category",
"termCode": "DerivedSoilProfile",
"url": "http://inspire.ec.europa.eu/featureconcept/DerivedSoilProfile"
},
"distribution": {
"type": "DataDownload",
"encodingFormat": "TIF",
"lockedForDownload": false
},
"size": {
"type": "QuantitativeValue",
"value": "13",
"unitCode": "files"
}
},
{
"type": "DataSet",
"id": "https://api.varda.ag/soilhive/v1/datasets/31",
"identifier": 31,
"name": "Africa SoilGrid properties",
"description": "Over the period 2008–2014, the AfSIS project has compiled two soil profiles / samples datasets: the Africa Soil Profiles database holding legacy soil profiles data and the Sentinel Sites database holding newly collected topsoil data, jointly consisting of around 28 thousand sampling locations and a total of 85 thousands samples. Using these soil point observations & measurements and an extensive collection of global (SoilGrids1km) and continental (Africa) environmental covariates, ISRIC - World Soil Information, in collaboration with The Earth Institute, Columbia University, World Agroforestry Centre, Nairobi and the International Center for Tropical Agriculture (CIAT), has produced predictions of soil properties for the whole African continent at 250 m spatial resolution at either two or six standard soil depths.",
"url": "https://files.isric.org/public/af250m_nutrient/",
"measurementTechnique": {
"type": "DefinedTerm",
"name": "D2.8.III.3 INSPIRE Data Specification on Soil, soil profile category",
"termCode": "DerivedSoilProfile",
"url": "http://inspire.ec.europa.eu/featureconcept/DerivedSoilProfile"
},
"distribution": {
"type": "DataDownload",
"encodingFormat": "TIF",
"lockedForDownload": false
},
"size": {
"type": "QuantitativeValue",
"value": "34",
"unitCode": "files"
}
},
{
"type": "DataSet",
"id": "https://api.varda.ag/soilhive/v1/datasets/1",
"identifier": 1,
"name": "Global Soil Organic Carbon Map",
"description": "GSOCmap is the first global soil organic carbon map ever produced through a consultative and participatory process involving member countries, which makes this map totally new and unique. In fact, the map was prepared by member countries, under the guidance of the Intergovernmental Technical Panel on Soils and the Global Soil Partnership Secretariat. Countries agreed on the methodology to produce the map and were trained on modern tools and methodologies to develop national maps. The Global Soil Partnership then gathered all national maps to produce the final product, ensuring a thorough harmonization process.<br/><br/>Note: <em>The dataset comes along with a technical report which presents methodologies and the process of compiling the Global Soil organic Carbon Map. The link to download the report is available in the on-line resources.</em>",
"url": "http://54.229.242.119/GSOCmap/",
"measurementTechnique": {
"type": "DefinedTerm",
"name": "D2.8.III.3 INSPIRE Data Specification on Soil, soil profile category",
"termCode": "DerivedSoilProfile",
"url": "http://inspire.ec.europa.eu/featureconcept/DerivedSoilProfile"
},
"distribution": {
"type": "DataDownload",
"encodingFormat": "TIF",
"lockedForDownload": false
},
"size": {
"type": "QuantitativeValue",
"value": "1",
"unitCode": "files"
}
},
{
"type": "DataSet",
"id": "https://api.varda.ag/soilhive/v1/datasets/4",
"identifier": 4,
"name": "Harmonized World Soil Database",
"description": "The Harmonized World Soil Database version 2.0 (HWSD v2.0) is a unique global soil inventory providing information on the morphological, chemical and physical properties of soils at approximately 1 km resolution. Its main objective is to be useful for modelers and to serve as a basis for prospective studies on agroecological zoning, food security and the impacts of climate change. HWSD v2.0 also serves an educational function, illustrating the geographical distribution of soils as well as their properties globally.",
"url": "https://gaez.fao.org/pages/hwsd",
"measurementTechnique": {
"type": "DefinedTerm",
"name": "D2.8.III.3 INSPIRE Data Specification on Soil, soil profile category",
"termCode": "DerivedSoilProfile",
"url": "http://inspire.ec.europa.eu/featureconcept/DerivedSoilProfile"
},
"distribution": {
"type": "DataDownload",
"encodingFormat": "TIF",
"lockedForDownload": true
}
},
{
"type": "DataSet",
"id": "https://api.varda.ag/soilhive/v1/datasets/12",
"identifier": 12,
"name": "iSDA Africa Field Data",
"description": "iSDA is an IT consulting service aiming to help smallholder farmers across Africa increase their productivity using advanced technologies while also improvIng their profitability and the well-being of their communities.<br/><br/>Founded by three research institutes - Rothamsted Research, the World Agroforestry Centre (ICRAF) and the International Institute of Tropical Agriculture (IITA) - iSDA is a mission-driven company carries forward the legacy of the African Soils Information Service (AfSIS).<br/><br/>ISDA has released a large dataset of analysed soil samples covering the African continent. These data are analysis-ready and do not require any preprocessing before usage. The dataset was collected and analysed according to protocols created by the African Soil Information Service (AfSIS) project (Vågen T-G et al., 2010). AfSIS was an initiative funded by the Bill and Melinda Gates Foundation, aimed at improving soil information across Africa. Data were collected and analysed between 2008 and 2020. In total, over 50,000 soil samples were collected across more than 15 countries.",
"url": "https://github.com/iSDA-Africa/open-soil-data",
"measurementTechnique": {
"type": "DefinedTerm",
"name": "D2.8.III.3 INSPIRE Data Specification on Soil, soil profile category",
"termCode": "ObservedSoilProfile",
"url": "https://inspire.ec.europa.eu/featureconcept/ObservedSoilProfile"
},
"distribution": {
"type": "DataDownload",
"encodingFormat": "GeoJSON",
"lockedForDownload": false
},
"size": {
"type": "QuantitativeValue",
"value": "21",
"unitCode": "data points"
}
},
{
"type": "DataSet",
"id": "https://api.varda.ag/soilhive/v1/datasets/17",
"identifier": 17,
"name": "iSDAsoil",
"description": "iSDAsoil is a soil resource created by <a href=\"https://isda-africa.com/\" target=\"_blank\">iSDA</a>, containing soil property predictions at 30m resolution for the entire African continent.<br/><br/>Maps for over 20 different soil properties have been created at 2 different depths (0-20 and 20-50cm). Soil property predictions were made using machine learning coupled with remote sensing data and a training set of over 100,000 analyzed soil samples. Included in this dataset are images of predicted soil properties, model error and satellite covariates used in the mapping process.<br/><br/>To explore the iSDAsoil data, it is recommended to visit the <a href=\"https://isda-africa.com/isdasoil\" target=\"_blank\">iSDAsoil homepage</a>.<br/>Further information can be found in the <a href=\"https://www.isda-africa.com/isdasoil/faq/\" target=\"_blank\">FAQ section</a>, and <a href=\"https://www.isda-africa.com/isdasoil/technical-information/\" target=\"_blank\">technical information documentation</a>",
"url": "https://zenodo.org/search?q=iSDAsoil&l=list&p=1&s=20&sort=bestmatch",
"measurementTechnique": {
"type": "DefinedTerm",
"name": "D2.8.III.3 INSPIRE Data Specification on Soil, soil profile category",
"termCode": "DerivedSoilProfile",
"url": "http://inspire.ec.europa.eu/featureconcept/DerivedSoilProfile"
},
"distribution": {
"type": "DataDownload",
"encodingFormat": "TIF",
"lockedForDownload": false
},
"size": {
"type": "QuantitativeValue",
"value": "36",
"unitCode": "files"
}
},
{
"type": "DataSet",
"id": "https://api.varda.ag/soilhive/v1/datasets/19",
"identifier": 19,
"name": "SoilGrids — global gridded soil information",
"description": "SoilGrids is designed as a globally consistent, data-driven system that predicts soil properties and classes using global covariates and globally fitted models. If you are looking for soil information on national and/or local levels we advise you, before using SoilGrids, to compare SoilGrids predictions with soil maps derived from national and local soil geographical databases. National soil maps are usually based on more detailed input soil information and therefore are often more accurate than SoilGrids (within the local coverage area). For an overview of national and regional soil databases, please refer to the Soil Geographic Databases compendium.<br/><br/>The selection of soil profiles underpinning SoilGrids is larger than the publicly available set ('wosis_latest') displayed here (for details see the ESSD paper). The actual number of observations for each property varies (greatly) between profiles and with depth, generally depending on the objectives of the initial soil sampling programmes. National soil survey organisations will generally maintain a wider selection of soil profiles/properties for their country in their databases.",
"url": "https://soilgrids.org/",
"measurementTechnique": {
"type": "DefinedTerm",
"name": "D2.8.III.3 INSPIRE Data Specification on Soil, soil profile category",
"termCode": "DerivedSoilProfile",
"url": "http://inspire.ec.europa.eu/featureconcept/DerivedSoilProfile"
},
"distribution": {
"type": "DataDownload",
"encodingFormat": "TIF",
"lockedForDownload": false
},
"size": {
"type": "QuantitativeValue",
"value": "61",
"unitCode": "files"
}
},
{
"type": "DataSet",
"id": "https://api.varda.ag/soilhive/v1/datasets/13",
"identifier": 13,
"name": "TARI_SoilHealthProject",
"description": "TARI is a leading research institution in Tanzania that is dedicated to promoting sustainable agricultural development and improving agricultural productivity. Established in 2016, TARI is the national agricultural research organization responsible for generating and disseminating scientific knowledge and innovative agricultural technologies.<br/><br/>As part of this mandate, TARI collaborated together with Varda and other players in a feasibility study to implement a large-scale liming program to enhance the productivity of acidic soils in Tanzania and boost soil health. Within this project they have provided a soil dataset that was used for modelling purposes. The data were cleaned,processed and transformed into Shapefile format for spatial analysis. Following this, we harmonized the data in terms of vocabulary and unit of measurement. During the harmonization process, certain parameters were excluded from the dataset as they were not necessary for the modeling activities. <br/>More information on the data lineage can be provided under request.",
"measurementTechnique": {
"type": "DefinedTerm",
"name": "D2.8.III.3 INSPIRE Data Specification on Soil, soil profile category",
"termCode": "ObservedSoilProfile",
"url": "https://inspire.ec.europa.eu/featureconcept/ObservedSoilProfile"
},
"distribution": {
"type": "DataDownload",
"encodingFormat": "GeoJSON",
"lockedForDownload": false
},
"size": {
"type": "QuantitativeValue",
"value": "137",
"unitCode": "data points"
}
},
{
"type": "DataSet",
"id": "https://api.varda.ag/soilhive/v1/datasets/8",
"identifier": 8,
"name": "World Soil Information Service (WoSIS)",
"description": "The aim of the World Soil Information Service (WoSIS) is to serve quality-assessed, georeferenced soil data (point, polygon, and grid) to the international community upon their standardisation and harmonisation. So far, the focus has been on developing procedures for legacy point data with special attention to the selection of soil analytical and physical properties considered in the GlobalSoilMap specifications (e.g. organic carbon, soil pH, soil texture (sand, silt, and clay), coarse fragments ( < 2 mm), cation exchange capacity, electrical conductivity, bulk density, and water holding capacity). Profile data managed in WoSIS were contributed by a wide range of soil data providers; the data have been described, sampled, and analysed according to methods and standards in use in the originating countries. Hence, special attention was paid to measures for soil data quality and the standardisation of soil property definitions, soil property values, and soil analytical method descriptions.<br/><br/>At present, WoSIS_latest contains standardized data for 217,000 profiles. The number of measured data for each property varies between profiles and with depth, generally depending on the purpose of the initial studies. Further, in most source datasets, there are fewer data for soil physical as opposed to soil chemical attributes and there are fewer measurements for deeper than for superficial horizons. Generally, limited quality information is associated with the various source data.",
"url": "https://data.isric.org/geonetwork/srv/eng/catalog.search#/metadata/f41367e5-f4d2-4b73-81aa-a472730e1519",
"measurementTechnique": {
"type": "DefinedTerm",
"name": "D2.8.III.3 INSPIRE Data Specification on Soil, soil profile category",
"termCode": "ObservedSoilProfile",
"url": "https://inspire.ec.europa.eu/featureconcept/ObservedSoilProfile"
},
"distribution": {
"type": "DataDownload",
"encodingFormat": "GeoJSON",
"lockedForDownload": false
},
"size": {
"type": "QuantitativeValue",
"value": "10",
"unitCode": "data points"
}
}
]
}
3 datasets correspond with the search of the user and they have point data which are Tari (ID=13), ISDA (ID=8), and Wosis (ID=12).
Step 4 : Call the POST operation of Soil Data By Area Queries to request the download
The user will now be able to request the download of the data by invoking “Soil Data by Area Queries” since his area of interest is bigger than 10 Hectares. They can specify the location of interest, the spatial and property filters, the data sources he is interested in, the years' margin, and point data.
The user can also provide his email in order to receive the download link to their email inbox as well.
curl --request POST \
--url https://api.varda.ag/soilhive/v1/soil-data-by-area-queries \
--header 'accept: application/json' \
--header 'authorization: Bearer {access-token}' \
--header 'content-type: application/json' \
--data '
{
"areaOfInterest": "POLYGON ((36.362 -3.246095, 36.999207 -3.200848, 37.040405 -3.538093, 36.390839 -3.57236, 36.362 -3.246095))",
"spatialFilters": [32],
"soilProperties": [1,31,4],
"startYear": 2004,
"endYear": 2024,
"dataSets": [13,8,12],
"gisDataTypes": ["point"]
}'
{
"Location": "https://api.varda.ag/soilhive/v1/soil-data-by-area-queries/5db6b80b-0a00-4b5a-972c-2a988c7ca4fd"
}
Step 5 : Call the GET operation of the Soil Data By Area Queries to check the status of the download job to receive the download link
The user has to go invoke the get operation and check the status of the job ID” 5db6b80b-0a00-4b5a-972c-2a988c7ca4fd” in order to get the download link
curl --request GET \
--url https://api.varda.ag/soilhive/v1/soil-data-by-area-queries/5db6b80b-0a00-4b5a-972c-2a988c7ca4fd \
--header 'accept: application/ld+json' \
--header 'authorization: Bearer {access-token}' \
{
"@context": "https://api.varda.ag/soilhive/v1/core.jsonld",
"id": "https://api.varda.ag/soilhive/v1/soil-data-by-area-queries/5db6b80b-0a00-4b5a-972c-2a988c7ca4fd",
"type": "Action",
"actionStatus": "Completed",
"description": "Completed file, ready for download",
"startTime": "2024-10-09T12:46:01.385Z",
"endTime": "2024-10-09T12:46:33.442Z",
"result": {
"type": "DataDownload",
"url": "https://varda-prd-euc1-gsp-data-source.s3.amazonaws.com/download/5db6b80b-0a00-4b5a-972c-2a988c7ca4fd_1728477961290.zip",
"expires": "2024-10-16T12:46:33.442Z"
}
}
Outcome
The user can now download the data from the provide link, ie : https://varda-prd-euc1-gsp-data-source.s3.amazonaws.com/download/5db6b80b-0a00-4b5a-972c-2a988c7ca4fd_1728477961290.zip
Updated 7 days ago