Application Programming Interface (API)

API-Attribute 'ElevationProfileRequest'

Der API-Aufruf 'ElevationProfileRequest' generiert ein Höhenprofil zwischen einem Startpunkt (PointA) und einem Endpunkt (PointB). Die Punkte können in den Koordinatensystemen Longitude/Latitude oder UTM angegeben werden. Die Antwort enthält das berechnete Höhenprofil als eine Liste von Punkten mit Distanz, Höhe und Koordinaten, sowie Metadaten zur Attributierung.

Attribut Subattribut Subattribut Datentyp Beschreibung
Type string Typ der Anfrage (ElevationProfileRequest)
ID string Eindeutige ID der Anfrage
Attributes struct Attribute der Anfrage
PointA struct Startpunkt des Profils
Longitude float Längengrad (Dezimalgrad)
Latitude float Breitengrad (Dezimalgrad)
Zone int UTM Zone
Easting float Easting, X, Ostwert
Northing float Northing, Y, Nordwert
PointB struct Endpunkt des Profils
Longitude float Längengrad (Dezimalgrad)
Latitude float Breitengrad (Dezimalgrad)
Zone int UTM Zone
Easting float Easting, X, Ostwert
Northing float Northing, Y, Nordwert
MaxTotalProfilePoints int Maximale Anzahl der Punkte im Ergebnisprofil
MinStepSize float Minimale Schrittweite zwischen den Punkten in Metern

API-Attribute 'ElevationProfileResponse'

Attribut Subattribut Subattribut Datentyp Beschreibung
Type string Typ der Antwort (ElevationProfileResponse)
ID string ID der Antwort
Attributes struct Attribute der Antwort
PointA struct Startpunkt des Profils (wie in der Anfrage)
PointB struct Endpunkt des Profils (wie in der Anfrage)
MaxTotalProfilePoints int Maximale Anzahl der Punkte (wie in der Anfrage)
MinStepSize float Minimale Schrittweite (wie in der Anfrage)
Profile []struct Array der berechneten Profilpunkte
Distance float Distanz vom Startpunkt in Metern
Elevation float Höhe an diesem Punkt in Metern
Longitude float Längengrad des Punkts (Dezimalgrad)
Latitude float Breitengrad des Punkts (Dezimalgrad)
Easting float Easting des Punkts
Northing float Northing des Punkts
Attribution string Attribution der Datenquelle für diesen Punkt
Attributions []string Liste aller für das Profil verwendeten Datenquellen
IsError bool Fehler (ja/nein)
Error struct Fehlerdetails
Code string Fehlernummer
Title string Fehlerbeschreibung
Details string Fehlerdetaillierung

Eingabe:

Ausgabe:

Anmerkungen:

ElevationProfileRequest (Beispiel)


#!/bin/bash
#
# Abfrage ElevationProfile zwischen zwei Punkten via Lon/Lat. 

postdata=$(cat <<EOF
{
  "Type": "ElevationProfileRequest",
  "ID": "Test Maifisch LonLat",
  "Attributes": {
    "PointA": {
      "Longitude": 7.234057,
      "Latitude": 51.722921
    },
    "PointB": {
      "Longitude": 7.234519,
      "Latitude": 51.721705
    },
    "MaxTotalProfilePoints": 50,
    "MinStepSize": 1.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/elevationprofile

ElevationProfileResponse:


HTTP/2 200
access-control-allow-headers: Content-Type
access-control-allow-methods: POST
access-control-allow-origin: *
content-type: application/json; charset=utf-8
date: Thu, 04 Sep 2025 08:07:54 GMT

{
  "Type": "ElevationProfileResponse",
  "ID": "Test-Profil Maifisch LonLat",
  "Attributes": {
    "PointA": {
      "Longitude": 7.234057,
      "Latitude": 51.722921,
      "Zone": 0,
      "Easting": 0,
      "Northing": 0
    },
    "PointB": {
      "Longitude": 7.234519,
      "Latitude": 51.721705,
      "Zone": 0,
      "Easting": 0,
      "Northing": 0
    },
    "MaxTotalProfilePoints": 50,
    "MinStepSize": 1,
    "Profile": [
      {
        "Distance": 0,
        "Elevation": 39.77000045776367,
        "Longitude": 7.234057000025448,
        "Latitude": 51.722920998887616,
        "Easting": 0,
        "Northing": 0,
        "Attribution": "DE-NW, 2020-02"
      },
      {
        "Distance": 2.836328507741234,
        "Elevation": 39.790000915527344,
        "Longitude": 7.2340664288522225,
        "Latitude": 51.722896182583966,
        "Easting": 0,
        "Northing": 0,
        "Attribution": "DE-NW, 2020-02"
      },
...
      {
        "Distance": 136.14376837157923,
        "Elevation": 37.31999969482422,
        "Longitude": 7.2345095717093475,
        "Latitude": 51.72172981523702,
        "Easting": 0,
        "Northing": 0,
        "Attribution": "DE-NW, 2020-02"
      },
      {
        "Distance": 138.98009687932046,
        "Elevation": 37.4900016784668,
        "Longitude": 7.23451900002544,
        "Latitude": 51.7217049988876,
        "Easting": 0,
        "Northing": 0,
        "Attribution": "DE-NW, 2020-02"
      }
    ],
    "Attributions": [
      "DE-NW: © GeoBasis-DE / NRW (2025), dl-de/by-2-0"
    ],
    "IsError": false,
    "Error": {
      "Code": "",
      "Title": "",
      "Detail": ""
    }
  }
}

© 2025 - Höhendaten für Deutschland