Retrieving soil data

Soil data can be queried specifying an area of interest. API requests should be sent to different endpoints depending on area size:

• area < 10,000 m² (10 ha):

  • POST /v1/soil-data-by-geometry: request is synchronous (blocking). Data will be returned in JSON format.

• 10,000 m² < area < 30,000,000 Km²:

  • POST /v1/soil-data-by-geometry/queries: endpoint will create a request that will asynchronously extract the data. An email address can be specified in the payload to be notified on completion.
  • GET /v1/soil-data-by-geometry/queries/{query-id}: endpoint returns the status of a query given the ID provided in the previous call.

Filtering

Other than area of interest, additional filtering can be specified in the payload:

• Spatial filters
• Soil properties
• Date range
• Data sources