Skip to content

← API reference

Soil at the address: class, texture, drainage and limiting property

soil_quality17 fieldsNot in the demo
Source
NIBIO Jordsmonn (harmonised soil map) WMS, live at the address point
Geography
The address point
Reported stale after
1 year
Access
Requires an API key granted this section
Contract version
1

What this does not say

Quoted verbatim from the section’s warnings field, exactly as the API returns it. They are not translated: a translation would show something other than what your response actually contains.

  • NIBIO maps farmland (fulldyrket and overflatedyrket jord) that has been surveyed; gardens, built-up land, forest and unsurveyed areas have no figure, so not_found says the point is unmapped, not that the ground has no soil qualities worth knowing.
  • A survey figure describes the soil across the mapped figure at the survey year, not a test of this plot. Drainage is the natural drainage class before any installed drainage.
  • Data from NIBIO Jordsmonn, NLOD 2.0.

Fields

5 of 17 fields are value fields — the ones that decide whether a record actually says anything. The rest are context: identifiers, codes and timestamps.

FieldTypeRole
mappedbooleancontext
soil_classstring | nullvalue
soil_class_codestring | nullcontext
soil_class_descriptionstring | nullcontext
dominant_soil_typestring | nullcontext
texturestring | nullvalue
drainagestring | nullvalue
drainage_descriptionstring | nullcontext
limiting_propertystring | nullvalue
organic_matterstring | nullvalue
slope_classstring | nullcontext
stone_classstring | nullcontext
mapped_yearinteger | nullcontext
mapping_methodstring | nullcontext
figure_idstring | nullcontext
municipality_namestring | nullcontext
retrieved_atdate-timecontext

Fetch this section

curl -H "X-API-Key: $APPROACH_API_KEY" \
  "https://api.approach.no/api/v1/addresses/285717643?include=soil_quality"

# paginated, one section at a time
curl -H "X-API-Key: $APPROACH_API_KEY" \
  "https://api.approach.no/api/v1/addresses/285717643/sections/soil_quality?limit=25"

Why it cannot be tried here

This section is not part of the public demo projection. That is a licensing and privacy decision, not a sign the data is missing: it is served to customers granted the section.