Höhenprofil (`/height`)

Liefert Geländehöhen zu Koordinaten — einzeln oder als Profil entlang eines Wegs. In früheren Fassungen dieser Doku fehlte der Endpunkt; er ist seit Langem verfügbar und wird im Produkt für die Höhenprofile von Touren benutzt.

POST https://valhalla.pixelmap.at/height

Höhen zu einzelnen Punkten

curl -H "Authorization: Bearer <IHR-TOKEN>" -X POST -H "Content-Type: application/json" \
  -d '{"shape": [{"lat": 46.6247, "lon": 14.3053}, {"lat": 46.6103, "lon": 13.8558}]}' \
  "https://valhalla.pixelmap.at/height"

{
  "shape": [ … ],
  "height": [448, 494]
}

Profil mit Distanzachse

Mit "range": true kommt zu jeder Höhe die aufsummierte Entfernung entlang der Linie — das, was ein Höhenprofil zum Zeichnen braucht:

curl -H "Authorization: Bearer <IHR-TOKEN>" -X POST -H "Content-Type: application/json" \
  -d '{"range": true, "shape": [{"lat": 46.6247, "lon": 14.3053}, {"lat": 46.6103, "lon": 13.8558}]}' \
  "https://valhalla.pixelmap.at/height"

{
  "shape": [ … ],
  "range_height": [[0, 448], [34407, 494]]
}

Gemessen am 14.09.2026: Klagenfurt 448 m, Villach 494 m, Abstand 34.407 m Luftlinie entlang der angegebenen Linie.

range misst die eingegebene Linie, nicht die Straße

Die Distanzachse folgt Ihren Punkten, nicht einem Straßenverlauf. Zwei Punkte ergeben eine gerade Verbindung — hier 34,4 km, während die gefahrene Route zwischen denselben Orten 39,0 km lang ist.

Für das Profil einer Route geben Sie deshalb die Punkte der Route ein: legs[].shape aus der /route-Antwort dekodieren (Präzision 6!) und als shape übergeben.

Einheiten

Höhen kommen in Metern, Entfernungen in Metern — unabhängig von units-Angaben anderer Endpunkte.

Punkte ohne Höhendaten liefern null an ihrer Stelle, nicht einen Fehler für die ganze Anfrage — gemessen mit einem Punkt auf offener See:

{"shape": [{"lat": 0.0, "lon": 0.0}, {"lat": 46.6247, "lon": 14.3053}],
 "height": [null, 448]}

Prüfen Sie also auf null, statt eine Zahl vorauszusetzen.