Application Programming Interface (API)

API-Attribute 'HistogramRequest'

Der API-Aufruf 'HistogramRequest' generiert Histogramm-Daten für einen Kartenausschnitt von 1x1 km. Der Kartenausschnitt wird durch einen beliebigen Referenzpunkt bestimmt. Der Referenzpunkt kann in den Koordinatensystemen Longitude/Latitude oder UTM angegeben werden. Das Histogramm kann für verschiedene Visualisierungstypen (Höhendaten, Hangneigung, Hangexposition, Geländerauheit, TRI, TPI) erstellt werden. Die Antwort enthält die Histogramm-Daten sowie Metadaten zur Quelle und Attributierung.

Attribut Subattribut Datentyp Beschreibung
Type string Typ der Anfrage (HistogramRequest)
ID string Eindeutige ID der Anfrage
Attributes struct Attribute der Anfrage
Zone int UTM Zone Referenzpunkt
Easting float Easting, X, Ostwert Referenzpunkt
Northing float Northing, Y, Nordwert Referenzpunkt
Longitude float Längengrad Referenzpunkt (Dezimalgrad)
Latitude float Breitengrad Referenzpunkt (Dezimalgrad)
TypeOfVisualization string Typ der Visualisierung, für die das Histogramm erstellt wird (rawtif, slope, aspect, roughness, tri, tpi)
GradientAlgorithm string Algorithmus für die Steigungsberechnung ('Horn' oder 'ZevenbergenThorne') - nur relevant für Hangneigung und Hangexposition
TypeOfHistogram string Typ des zu erzeugenden Histogramms ('standard' oder 'quantile')
NumberOfBins int Anzahl der Bins (Klassen, Intervalle) für das Histogramm
MinValue string Minimaler Wert für das Histogramm (optional, leerer String für automatische Bestimmung)
MaxValue string Maximaler Wert für das Histogramm (optional, leerer String für automatische Bestimmung)

API-Attribute 'HistogramResponse'

Attribut Subattribut Subattribut Subattribut Datentyp Beschreibung
Type string Typ der Antwort (HistogramResponse)
ID string ID der Antwort
Attributes struct Attribute der Antwort
Zone int UTM Zone des angefragten Referenzpunkts
Easting float Easting, X, Ostwert des angefragten Referenzpunkts
Northing float Northing, Y, Nordwert des angefragten Referenzpunkts
Longitude float Längengrad des angefragten Referenzpunkts (Dezimalgrad)
Latitude float Breitengrad des angefragten Referenzpunkts (Dezimalgrad)
TypeOfVisualization string Typ der Visualisierung, für die das Histogramm erstellt wurde
GradientAlgorithm string Algorithmus für die Steigungsberechnung
TypeOfHistogram string Typ des Histogramms
NumberOfBins int Anzahl der Bins (Intervalle) für das Histogramm
MinValue string Minimaler Wert für das Histogramm
MaxValue string Maximaler Wert für das Histogramm
Histograms []struct Array von Histogramm-Datenobjekten
Statistic struct Statistiken zu den Histogramm-Daten
NoValueCount int Anzahl der Pixel ohne Wert
NoValuePercent float Prozentsatz der Pixel ohne Wert
BelowHistogramMinCount int Anzahl der Pixel unterhalb des Histogramm-Minimums
BelowHistogramMinPercent float Prozentsatz der Pixel unterhalb des Histogramm-Minimums
AboveHistogramMaxCount int Anzahl der Pixel oberhalb des Histogramm-Maximums
AboveHistogramMaxPercent float Prozentsatz der Pixel oberhalb des Histogramm-Maximums
ValuesTotal int Gesamtzahl der Pixel mit Werten
MinValueAbsolute float Absoluter Minimalwert in den Daten
MaxValueAbsolute float Absoluter Maximalwert in den Daten
MinValueHistogram float Minimalwert, der für die Histogramm-Bins verwendet wurde
MaxValueHistogram float Maximalwert, der für die Histogramm-Bins verwendet wurde
Entries []struct Array von Histogramm-Bins
LowerBound float Untere Grenze des Bins
UpperBound float Obere Grenze des Bins
BinCount int Anzahl der Werte in diesem Bin
BinPercent float Prozentsatz der Werte in diesem Bin
Actuality string Aktualität der Daten
Origin string Herkunft der Daten
Attribution string Attribution der Daten
TileIndex string Index der Quelldatenkachel
IsError bool Fehler (ja/nein)
Error struct Fehlerdetails
Code string Fehlernummer
Title string Fehlerbeschreibung
Detail string Fehlerdetaillierung

Eingabe:

Ausgabe:

Anmerkungen:

HistogramRequest (Beispiel)


#!/bin/bash
#
# Abfrage Histogramm für eine Kachel mit 1000x1000 Meter.

postdata=$(cat <<EOF
{
  "Type": "HistogramRequest",
  "ID": "Hegekopf, Edersee, Hessen",
  "Attributes": {
    "Zone": 0,
    "Easting": 0.0,
    "Northing": 0.0,
    "Longitude": 8.964229,
    "Latitude": 51.185913,
    "TypeOfVisualization": "slope",
    "GradientAlgorithm": "Horn",
    "TypeOfHistogram": "standard",
    "NumberOfBins": 20,
    "MinValue": "",
    "MaxValue": ""
  }
}
EOF
)

echo "postdata = $postdata"

curl \
--silent \
--include \
--compressed \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Accept-Encoding: gzip" \
--data "$postdata" \
https://api.hoehendaten.de:14444/v1/histogram

HistogramResponse:


HTTP/2 200
access-control-allow-headers: Content-Type
access-control-allow-methods: POST
access-control-allow-origin: *
content-encoding: gzip
content-type: application/json; charset=utf-8
content-length: 1041
date: Sat, 09 Aug 2025 11:53:18 GMT

{
  "Type": "HistogramResponse",
  "ID": "Hegekopf, Edersee, Hessen",
  "Attributes": {
    "Zone": 0,
    "Easting": 0,
    "Northing": 0,
    "Longitude": 8.964229,
    "Latitude": 51.185913,
    "TypeOfVisualization": "slope",
    "GradientAlgorithm": "Horn",
    "TypeOfHistogram": "standard",
    "NumberOfBins": 20,
    "MinValue": "",
    "MaxValue": "",
    "Histograms": [
      {
        "Statistic": {
          "NoValueCount": 0,
          "NoValuePercent": 0,
          "BelowHistogramMinCount": 0,
          "BelowHistogramMinPercent": 0,
          "AboveHistogramMaxCount": 0,
          "AboveHistogramMaxPercent": 0,
          "ValuesTotal": 1000000,
          "MinValueAbsolute": 0,
          "MaxValueAbsolute": 68.45832,
          "MinValueHistogram": 0,
          "MaxValueHistogram": 68.45832
        },
        "Entries": [
          {
            "LowerBound": 0,
            "UpperBound": 3.422916,
            "BinCount": 325666,
            "BinPercent": 32.5666
          },
          {
            "LowerBound": 3.422916,
            "UpperBound": 6.845832,
            "BinCount": 139928,
            "BinPercent": 13.992799999999999
          },
          {
            "LowerBound": 6.845832,
            "UpperBound": 10.268747999999999,
            "BinCount": 63580,
            "BinPercent": 6.358
          },
          {
            "LowerBound": 10.268747999999999,
            "UpperBound": 13.691664,
            "BinCount": 38038,
            "BinPercent": 3.8038000000000003
          },
          {
            "LowerBound": 13.691664,
            "UpperBound": 17.11458,
            "BinCount": 40758,
            "BinPercent": 4.0758
          },
          {
            "LowerBound": 17.11458,
            "UpperBound": 20.537495999999997,
            "BinCount": 54426,
            "BinPercent": 5.4426000000000005
          },
          {
            "LowerBound": 20.537495999999997,
            "UpperBound": 23.960411999999998,
            "BinCount": 65215,
            "BinPercent": 6.5215
          },
          {
            "LowerBound": 23.960411999999998,
            "UpperBound": 27.383328,
            "BinCount": 77736,
            "BinPercent": 7.7736
          },
          {
            "LowerBound": 27.383328,
            "UpperBound": 30.806244,
            "BinCount": 78175,
            "BinPercent": 7.817499999999999
          },
          {
            "LowerBound": 30.806244,
            "UpperBound": 34.22916,
            "BinCount": 56286,
            "BinPercent": 5.6286000000000005
          },
          {
            "LowerBound": 34.22916,
            "UpperBound": 37.652076,
            "BinCount": 33161,
            "BinPercent": 3.3161000000000005
          },
          {
            "LowerBound": 37.652076,
            "UpperBound": 41.074991999999995,
            "BinCount": 14443,
            "BinPercent": 1.4443
          },
          {
            "LowerBound": 41.074991999999995,
            "UpperBound": 44.497907999999995,
            "BinCount": 6696,
            "BinPercent": 0.6696
          },
          {
            "LowerBound": 44.497907999999995,
            "UpperBound": 47.920823999999996,
            "BinCount": 2993,
            "BinPercent": 0.2993
          },
          {
            "LowerBound": 47.920823999999996,
            "UpperBound": 51.34374,
            "BinCount": 1371,
            "BinPercent": 0.1371
          },
          {
            "LowerBound": 51.34374,
            "UpperBound": 54.766656,
            "BinCount": 735,
            "BinPercent": 0.0735
          },
          {
            "LowerBound": 54.766656,
            "UpperBound": 58.189572,
            "BinCount": 441,
            "BinPercent": 0.0441
          },
          {
            "LowerBound": 58.189572,
            "UpperBound": 61.612488,
            "BinCount": 233,
            "BinPercent": 0.0233
          },
          {
            "LowerBound": 61.612488,
            "UpperBound": 65.035404,
            "BinCount": 91,
            "BinPercent": 0.0091
          },
          {
            "LowerBound": 65.035404,
            "UpperBound": 68.45832,
            "BinCount": 28,
            "BinPercent": 0.0028
          }
        ],
        "Actuality": "2021-04-26",
        "Origin": "DE-HE",
        "Attribution": "Geobasisdaten © Hessische Verwaltung für Bodenmanagement und Geoinformation, dl-de/by-2-0",
        "TileIndex": "32_497_5670"
      }
    ],
    "IsError": false,
    "Error": {
      "Code": "",
      "Title": "",
      "Detail": ""
    }
  }
}

© 2025 - Höhendaten für Deutschland