API - ContoursRequest

Application Programming Interface (API)

API-Attribute 'ContoursRequest'

Der API-Aufruf 'ContoursRequest' gibt die Höhenlinien für einen Kartenausschnitt von 1x1 km im Format GeoJSON zurück. Der Kartenausschnitt wird durch einen beliebigen Referenzpunkt bestimmt. Der Referenzpunkt kann in den Koordinatensystemen Longitude/Latitude oder UTM angegeben werden. Die Koordinaten der errechneten Höhenlinien entsprechen dem gewählten Eingabe-Koordinatensystem: EPSG:4326 für Lon/Lat und EPSG:25832 oder EPSG:25833 für UTM. Die Äquidistanz der Höhenlinien ist in Metern (z.B. 0.5 oder 2.0) anzugeben. Die Antwort kann Daten für eine, zwei oder drei Kacheln enthalten, falls eine Landesgrenze den Bereich schneidet. Der Body der Antwort ist komprimiert (gzip).

Attribut	Subattribut	Datentyp	Beschreibung
Type		string	Typ der Anfrage (ContoursRequest)
ID		string	Eindeutige ID der Anfrage
Attributes		struct	Attribute der Anfrage
	Longitude	float	Längengrad Referenzpunkt (Dezimalgrad)
	Latitude	float	Breitengrad Referenzpunkt (Dezimalgrad)
	Zone	int	UTM Zone Referenzpunkt
	Easting	float	Easting, X, Ostwert Referenzpunkt
	Northing	float	Northing, Y, Nordwert Referenzpunkt
	Equidistance	float	Äquidistanz der Höhenlinien in Metern

API-Attribute 'ContoursResponse'

Attribut	Subattribut	Subattribut	Datentyp	Beschreibung
Type			string	Typ der Antwort (ContoursResponse)
ID			string	ID der Antwort
Attributes			struct	Attribute der Antwort
	Longitude		float	Längengrad des angefragten Referenzpunkts (Dezimalgrad)
	Latitude		float	Breitengrad des angefragten Referenzpunkts (Dezimalgrad)
	Zone		int	UTM Zone des angefragten Referenzpunkts
	Easting		float	Easting, X, Ostwert des angefragten Referenzpunkts
	Northing		float	Northing, Y, Nordwert des angefragten Referenzpunkts
	Equidistance		float	Äquidistanz der Höhenlinien in Metern
	Contours		[]struct	Array von Höhenlinien-Objekten
		Data	string	Höhenlinien für die Kachel
		DataFormat	string	Format der Daten (GeoJSON)
		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 Höhenschichtlinien erstellt werden.
Mögliche Eingabeformate:

Lon/Lat-Koordinaten (WGS84, EPSG:4326)
UTM-Koordinaten (EPSG:25832 / EPSG:25833)

Ausgabe:

Erzeugt werden Höhenschichtlinien im GeoJSON-Format.
Jede Höhenschichtlinie wird durch Koordinaten repräsentiert, die dem gewählten Eingabeformat entsprechen.
Mögliche Ausgabeformate:

Lon/Lat-Koordinaten (WGS84, EPSG:4326)
UTM-Koordinaten (EPSG:25832 / EPSG:25833)

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.Contours' die Daten für eine, zwei oder maximal drei Kacheln.
Der Body der Antwort ist komprimiert (gzip).

ContoursRequest (Beispiel)


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

# Kachel durch UTM-Koordinaten referenziert.
# Ergebnis: GeoJSON-Datei mit Höhenlinien in UTM-Koordinaten.
postdataUTM=$(cat <<EOF
{
  "Type": "ContoursRequest",
  "ID": "GPS-Referenzpunkt Hannover",
  "Attributes": {
    "Zone": 32,
    "Easting": 550251.23,
    "Northing": 5802052.35,
    "Longitude": 0.0,
    "Latitude": 0.0,
    "Equidistance": 1.0
  }
}
EOF
)

# oder

# Kachel durch Lon/Lat-Koordinaten referenziert.
# Ergebnis: GeoJSON-Datei mit Höhenlinien in Lon/Lat-Koordinaten.
postdataLonLat=$(cat <<EOF
{
  "Type": "ContoursRequest",
  "ID": "Langenberg (Rothaargebirge, höchster Berg in NRW)",
  "Attributes": {
    "Zone": 0,
    "Easting": 0.0,
    "Northing": 0.0,
    "Longitude": 8.558333,
    "Latitude": 51.276389,
    "Equidistance": 5.0
  }
}
EOF
)

echo "postdata =\n$postdataLonLat"

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

ContoursResponse:


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:07:20 GMT

{
  "Type": "ContoursResponse",
  "ID": "Langenberg (Rothaargebirge, höchster Berg in NRW)",
  "Attributes": {
    "Zone": 0,
    "Easting": 0,
    "Northing": 0,
    "Longitude": 8.558333,
    "Latitude": 51.276389,
    "Equidistance": 5,
    "Contours": [
      {
        "Data": "ewoidHlwZSI6ICJGZWF0dXJlQ29sbGVjdGlvbiIs ... jQsIDUxLjI3MDUwMTkxNDMzOTI5OSBdIF0gfSB9Cl0KfQo=",
        "DataFormat": "geojson",
        "Actuality": "2021-03",
        "Origin": "DE-NW",
        "Attribution": "© GeoBasis-DE / NRW (2025), dl-de/by-2-0",
        "TileIndex": "32_469_5680"
      },
      {
        "Data": "ewoidHlwZSI6ICJGZWF0dXJlQ29sbGVjdGlvbiIs ... MzY5LCA1MS4yNzA1MDE4OTAxMjA1NjMgXSBdIH0gfQpdCn0K",
        "DataFormat": "geojson",
        "Actuality": "2023-04-19",
        "Origin": "DE-HE",
        "Attribution": "Geobasisdaten © Hessische Verwaltung für Bodenmanagement und Geoinformation, dl-de/by-2-0",
        "TileIndex": "32_469_5680"
      }
    ],
    "IsError": false,
    "Error": {
      "Code": "",
      "Title": "",
      "Detail": ""
    }
  }
}