bgr-apis

BGR Soil Information

The Bundesanstalt für Geowissenschaften und Rohstoffe (BGR) provides information on soil quality, types and other factors significant for agricultural use in Germany. As the information is solely available as a mapping service, this repo is aimed at providing a Node-JS client API to the information available.

Installation

npm install bgr-apis

Methods

sqr(point,layer)

bgr.sqr({
  type: 'Point',
  coordinates: [6.9977272,50.778018]
}, 18)
.then(res => {
  // res = 72
})
.catch(err => {
  console.log(err)
})

Returns the soil quality rating (float) at a given point (see Mueller et al. (2007) for infomation on the SQR method).

Point can either be a GeoJSON point, an array of the form [lng, lat] or a GeoJSON feature (e.g. a plot). When a plot (GeoJSON feature) is entered, the centroid of the plot is used.

Optional parameters
layer You can specify another layer if you need information other than the soil quality index (defaults to 18)

Layer	Description (German)
18	Soil Quality Index (default)
17	Bewertung der Bodenarten
16	Bewertung des Humusvorrats
15	Bewertung der Bodenstruktur
14	Bewertung der Packungsdichte
13	Bewertung der effektiven Durchwurzelungstiefe
12	Bewertung des Bodenwasserdargebots
11	Bewertung des mittleren Grundwassertiefstands
10	Bewertung der Hangneigung
9	Bewertung der standörtlichen Bodengüte
7	Bewertung der Versauerungsgefährdung
6	Bewertung der Gründigkeit
5	Bewertung der Trockenheitsgefährdung
4	Bewertung des Steingehaltes im Wurzelraum
3	Ertragslimitierende Faktoren
2	Gefährdungsindikatorwerte

soilType(point)

bgr.soilType({
  type: 'Point',
  coordinates: [6.9977272,50.778018]
})
.then(res => {
  // res = 'Lehmsande (ls)'
})
.catch(err => {
  // handle errors
})

Returns the soil type (string, UTF-8, german) at a given point.
Possible categories are:

Soil Types
Reinsande (ss)
Lehmsande (ls)
Schluffsande (us)
Sandlehme (sl)
Normallehme (ll)
Tonlehme (tl)
Lehmschluffe (lu)
Tonschluffe (tu)
Schlufftone (ut)
Moore (mo)
Watt
Siedlung
Abbauflächen
Gewässer

Point can either be a GeoJSON point, an array of the form [lng, lat] or a GeoJSON feature (e.g. a plot). When a plot (GeoJSON feature) is entered, the centroid of the plot is used.

humusContent(point)

bgr.humusContent({
  type: 'Point',
  coordinates: [8.350689,52.087511]
})
.then(res => {
  // res = '2 - <3%'
})
.catch(err => {
  // handle errors
})

Return the humus content (string, UTF-8, german) for a given point. Possible categories are:

Humus content
1 - <2%
2 - <3%
3 - <4%
4 - <6%
6 - <8%
8 - <11,5%
11,5 - <15%
15 - <30%
≥30%
Wattflächen
Gewässerflächen
Siedlungen
Abbauflächen
nicht bestimmt

Point can either be a GeoJSON point, an array of the form [lng, lat] or a GeoJSON feature (e.g. a plot). When a plot (GeoJSON feature) is entered, the centroid of the plot is used.

Contribution

Contribution is highly appreciated! If you have improvements in code quality and/or additional features just open a pull.