Datasets

A dataset describes the source of a specific set of data, which may cover a region, a country or the entire world. There are three elements defining it:

• Identifier: a unique numeric value defined by SoilHive
• Metadata: text and numerical fields (e.g.: author, license, source link, ...) that describe the source
• Soil data: numerical values expressing one or more soil properties

Datasets may be queried and filtered using following endpoints that return metadata:

• GET /v1/datasets: retrieves all datasets.
• GET /v1/datasets/{id}: retrieves a dataset by id.
• POST /v1/datasets/queries: allows filtering by area of interest, spatial filters and soil properties.

Each dataset is associated to a numeric identifier returned in endpoint responses.
The identifier can be used as input in other endpoints to filter data.