Application Programming Interface (API)

---

API-Attribute 'ColorReliefRequest'

Der API-Aufruf 'ColorReliefRequest' generiert eine kolorierte Abbildung des Höhenreliefs 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. Die Antwort enthält die kolorierte Höhenrelief-Abbildung im GeoTIFF- oder PNG-Format (Base64-kodiert), sowie Metadaten zur Quelle und Attributierung.

Es ist eine Farbtextdatei für die Kolorierung zu übergeben. Die Antwort kann Daten für eine, zwei oder drei Kacheln enthalten, falls eine Landesgrenze den Bereich schneidet.

---

API-Attribute 'ColorReliefResponse'

Eingabe:

• Aus den Koordinaten eines Referenzpunkts wird die Kachel (1x1 km) abgeleitet, für die die Höhenrelief-Abbildungen erstellt werden.
• Mögliche Koordinatensysteme:
• Lon/Lat-Koordinaten (WGS84, EPSG:4326).
• UTM-Koordinaten (EPSG:25832 / EPSG:25833).

Ausgabe:

• Abhängig vom Eingabeformat werden unterschiedliche Ausgabeformate erzeugt:
• PNG in der Projektion EPSG:3857 (Webmercator) mit expliziter Georeferenzierung durch Lon/Lat-Koordinaten (WGS84, EPSG:4326).
• GeoTIFF in der Projektion der DGM1-Ausgangsdaten (EPSG:25832 / EPSG:25833) mit impliziter Georeferenzierung in den Metadaten.

Anmerkungen:

• Ein Kartenausschnitt wird in der Regel durch genau eine Kachel repräsentiert.
• Verläuft eine Landesgrenze durch eine Kachel, wird sie von allen betroffenen Bundesländer (2 oder 3) zur Verfügung gestellt.
• Entsprechend enthält das Feld 'Attributes.ColorReliefs' die Daten für eine, zwei oder maximal drei Kacheln.
• Der Body der Antwort ist komprimiert (gzip).

---

ColorReliefRequest (Beispiel)

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

postdata=$(cat <<EOF
{
  "Type": "ColorReliefRequest",
  "ID": "Hegekopf, Edersee, Hessen",
  "Attributes": {
    "Zone": 0,
    "Easting": 0.0,
    "Northing": 0.0,
    "Longitude": 8.964229,
    "Latitude": 51.185913,
    "ColorTextFileContent": [
      "# Farbdefinition für ColorRelief",
      "# Format: Wert Rot Grün Blau Alpha",
      "0 0 0 139 255",
      "200 0 191 255 255",
      "400 34 139 34 255",
      "600 50 205 50 255",
      "800 173 255 47 255",
      "1000 255 255 0 255",
      "1200 255 165 0 255",
      "1400 255 100 0 255",
      "1600 255 0 0 255",
      "1800 200 0 0 255",
      "2000 139 69 19 255",
      "2200 169 169 169 255",
      "2400 192 192 192 255",
      "2600 255 255 255 255",
      "nv 0 0 0 0"
    ],
    "ColoringAlgorithm": "interpolation"
  }
}
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/colorrelief

---

ColorReliefResponse:

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
date: Mon, 04 Aug 2025 08:28:56 GMT

{
  "Type": "ColorReliefResponse",
  "ID": "Hegekopf, Edersee, Hessen",
  "Attributes": {
    "Zone": 0,
    "Easting": 0,
    "Northing": 0,
    "Longitude": 8.964229,
    "Latitude": 51.185913,
    "ColorTextFileContent": [
      "# Farbdefinition für ColorRelief",
      "# Format: Wert Rot Grün Blau Alpha",
      "0 0 0 139 255",
      "200 0 191 255 255",
      "400 34 139 34 255",
      "600 50 205 50 255",
      "800 173 255 47 255",
      "1000 255 255 0 255",
      "1200 255 165 0 255",
      "1400 255 100 0 255",
      "1600 255 0 0 255",
      "1800 200 0 0 255",
      "2000 139 69 19 255",
      "2200 169 169 169 255",
      "2400 192 192 192 255",
      "2600 255 255 255 255",
      "nv 0 0 0 0"
    ],
    "ColoringAlgorithm": "interpolation",
    "ColorReliefs": [
      {
        "Data": "iVBORw0KGgoAAAANSUhEUgAAA+cAAAPqCAYAAADxYC ... 4kEon78f9mXSxez9e90AAAAABJRU5ErkJggg==",
        "DataFormat": "png",
        "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",
        "BoundingBox": {
          "MinLon": 8.95707049585795,
          "MaxLon": 8.971385896601037,
          "MinLat": 51.18141399484732,
          "MaxLat": 51.190410580109756
        }
      }
    ],
    "IsError": false,
    "Error": {
      "Code": "",
      "Title": "",
      "Detail": ""
    }
  }
}

---

© 2025 - Höhendaten für Deutschland