Application Programming Interface (API)


API-Attribute 'PointRequest'

Der API-Aufruf 'PointRequest' ermöglicht die Abfrage der genauen Höheninformation für einen einzelnen Punkt, der durch seine geographischen Koordinaten (Längengrad und Breitengrad in Dezimalgrad) spezifiziert wird. Die Antwort liefert neben der Höhe in Metern auch Informationen zur Aktualität, Herkunft und Attribution der verwendeten Höhendaten sowie den Index der Quelldatenkachel.

Attribut Subattribut Datentyp Beschreibung
Type string Typ der Anfrage (PointRequest)
ID string ID der Anfrage
Attributes struct Attribute der Anfrage
Longitude float Längengrad (Dezimalgrad)
Latitude float Breitengrad (Dezimalgrad)

API-Attribute 'PointResponse'

Attribut Subattribut Subattribut Datentyp Beschreibung
Type string Typ der Antwort (PointResponse)
ID string ID der Antwort
Attributes struct Attribute der Antwort
Longitude float Längengrad (Dezimalgrad)
Latitude float Breitengrad (Dezimalgrad)
Elevation float Höhenwert (Meter)
Actuality string Aktualität der Daten
Origin string Herkunft der Daten
Attribution string Attribution der Daten
TileIndex string Index der Quelldaten
IsError bool Fehler (ja/nein)
Error struct Fehlerdetails
Code string Fehlernummer
Title string Fehlerbeschreibung
Details string Fehlerdetaillierung

PointRequest (Beispiel)


#!/bin/bash
#
# Abfrage der Höhendaten für einen Lon/Lat Punkt

postdata=$(cat <<EOF
{
  "Type": "PointRequest",
  "ID": "Langenberg (Rothaargebirge, höchster Berg in NRW)",
  "Attributes": {
      "Longitude": 8.558333,
      "Latitude": 51.276389
  }
}
EOF
)

echo "postdata =\n$postdata"

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


PointResponse:


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
content-length: 450
date: Mon, 02 Jun 2025 06:50:59 GMT

{
  "Type": "PointResponse",
  "ID": "Langenberg (Rothaargebirge, höchster Berg in NRW)",
  "Attributes": {
    "Longitude": 8.558333,
    "Latitude": 51.276389,
    "Elevation": 843.0700073242188,
    "Actuality": "2021-03",
    "Origin": "DE-NW",
    "Attribution": "© GeoBasis-DE / NRW (2025), dl-de/by-2-0",
    "TileIndex": "32_469_5680",
    "IsError": false,
    "Error": {
      "Code": "",
      "Title": "",
      "Detail": ""
    }
  }
}