Application Programming Interface (API)

---

API-Attribute 'HillshadeRequest'

Der API-Aufruf 'HillshadeRequest' generiert eine Schummerungsabbildung (Hillshade) 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 Schummerungsabbildung im GeoTIFF- oder PNG-Format (Base64-kodiert) sowie Metadaten zur Quelle und Attributierung.

---

API-Attribute 'HillshadeResponse'

Eingabe:

• Aus den Koordinaten eines Referenzpunkts wird die Kachel (1x1 km) abgeleitet, für die die Schummerung erstellt wird.
• 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 durch alle betroffenen Bundesländer (2 oder 3) zur Verfügung gestellt.
• Entsprechend enthält das Feld 'Attributes.Hillshades' die Daten für eine, zwei oder maximal drei Kacheln.
• Der Body der Antwort ist komprimiert (gzip).

---

HillshadeRequest (Beispiel):

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

# Kachel durch UTM-Koordinaten referenziert.
postdataUTM=$(cat <<EOF
{
  "Type": "HillshadeRequest",
  "ID": "Klettersteinbruch Brumleytal",
  "Attributes": {
    "Zone": 32,
    "Easting": 409000.0,
    "Northing": 5790000.0,
    "Longitude": 0.0,
    "Latitude": 0.0,
    "GradientAlgorithm": "Horn",
    "VerticalExaggeration": 1.0,
    "AzimuthOfLight": 315,
    "AltitudeOfLight": 45,
    "ShadingVariant": "regular"
  }
}
EOF
)

# oder

# Kachel durch Lon/Lat-Koordinaten referenziert.
postdataLonLat=$(cat <<EOF
{
  "Type": "HillshadeRequest",
  "ID": "Langenberg (Rothaargebirge, höchster Berg in NRW)",
  "Attributes": {
    "Zone": 0,
    "Easting": 0.0,
    "Northing": 0.0,
    "Longitude": 8.558333,
    "Latitude": 51.276389,
    "GradientAlgorithm": "ZevenbergenThorne",
    "VerticalExaggeration": 1.0,
    "AzimuthOfLight": 315,
    "AltitudeOfLight": 45,
    "ShadingVariant": "regular"
  }
}
EOF
)

echo "postdata =\n$postdataUTM"

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

---

HillshadeResponse:

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, 09 Jun 2025 06:49:28 GMT

{
  "Type": "HillshadeResponse",
  "ID": "Klettersteinbruch Brumleytal",
  "Attributes": {
    "Zone": 32,
    "Easting": 409000,
    "Northing": 5790000,
    "Longitude": 0,
    "Latitude": 0,
    "GradientAlgorithm": "Horn",
    "VerticalExaggeration": 1,
    "AzimuthOfLight": 315,
    "AltitudeOfLight": 45,
    "ShadingVariant": "regular",
    "Hillshades": [
      {
        "Data": "SUkqAAgAAAAQAAABAwABAAAA6AMAAAEBAwABAAAA6AMA ... mZijraSemZaXm6Kelo2CiZGMjYqDioiDjI2Ic1xVXg==",
        "DataFormat": "geotiff",
        "Actuality": "2024-01",
        "Origin": "DE-NW",
        "Attribution": "© GeoBasis-DE / NRW (2025), dl-de/by-2-0",
        "TileIndex": "32_409_5790",
        "BoundingBox": {
          "MinLon": 0,
          "MaxLon": 0,
          "MinLat": 0,
          "MaxLat": 0
        }
      }
    ],
    "IsError": false,
    "Error": {
      "Code": "",
      "Title": "",
      "Detail": ""
    }
  }
}

---

© 2025 - Höhendaten für Deutschland