RawTIFRequest (API)

Application Programming Interface (API)

API-Attribute 'RawTIFRequest'

Der API-Aufruf 'RawTIFRequest' generiert Roh-Höhendaten (Digitales Geländemodell, DGM) für einen Kartenausschnitt von 1x1 km. Der Kartenausschnitt wird durch einen beliebigen Referenzpunkt bestimmt. Der Referenzpunkt muss in UTM-Koordinaten angegeben werden. Die Antwort enthält die Roh-Höhendaten im GeoTIFF-Format (Base64-kodiert), sowie Metadaten zur Quelle und Attributierung.

Die Antwort kann Daten für eine, zwei oder drei Kacheln enthalten, falls eine Landesgrenze den Bereich schneidet.

Attribut	Subattribut	Datentyp	Beschreibung
Type		string	Typ der Anfrage (RawTIFRequest)
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

API-Attribute 'RawTIFResponse'

Attribut	Subattribut	Subattribut	Datentyp	Beschreibung
Type			string	Typ der Antwort (RawTIFResponse)
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
	RawTIFs		[]struct	Array von Roh-Höhendaten (GeoTIFF) Abbildungen
		Data	string (Base64)	Roh-Höhendaten für die Kachel
		DataFormat	string	Format der Daten (GeoTIFF)
		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
		Details	string	Fehlerdetaillierung

Eingabe:

Aus den Koordinaten eines Referenzpunkts wird die Kachel (1x1 km) abgeleitet, für die die Roh-Höhendaten erstellt werden.
Mögliches Koordinatensystem:

UTM-Koordinaten (EPSG:25832 / EPSG:25833).

Ausgabe:

Die Ausgabe erfolgt im GeoTIFF-Format 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.RawTIFs' die Daten für eine, zwei oder maximal drei Kacheln.
Der Body der Antwort ist komprimiert (gzip).

RawTIFRequest (Beispiel)


#!/bin/bash
#
# Abfrage der originalen GeoTIIF-Höhendaten für eine Kachel mit 1000x1000 Meter. 

postdata=$(cat <<EOF
{
  "Type": "RawTIFRequest",
  "ID": "Hegekopf, Edersee, Hessen",
  "Attributes": {
    "Zone": 32,
    "Easting": 497500.0,
    "Northing": 5670500.0
  }
}
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/rawtif

RawTIFResponse:


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: Sat, 26 Jul 2025 07:02:59 GMT

{
  "Type": "RawTIFResponse",
  "ID": "Hegekopf, Edersee, Hessen",
  "Attributes": {
    "Zone": 32,
    "Easting": 497500,
    "Northing": 5670500,
    "RawTIFs": [
      {
        "Data": "SUkqAAgAAAAUAAABAwABAAAA6AMAAAEBAwABAAAA6AMAA ... Sj2QiIfRuIUb5ESlkkAweIWQiILMQYf4TpDgQL2AWzzIgI=",
        "DataFormat": "GeoTIFF",
        "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": ""
    }
  }
}