Zum Inhalt
HALOWERK

Kartenwerk

elevation profile

Takes a list of coordinates and returns the elevation at each, the distance and gradient between consecutive points, total ascent and descent, the steepest ramp with the segment it belongs to, and the mean gradient over the whole line. An optional resample interval inserts intermediate points along the great circle between the given ones, which is what makes a steepest-ramp figure meaningful on a route described by a handful of corners. The data is Copernicus DEM GLO-30, free for commercial.

POST https://karte.halowerk.com/v1/elevation-profile

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
pointsarrayJaThe line, in order. At least two coordinates.
resample_mnumberNeinInsert intermediate points every this many metres along each segment. Without it only the given points are sampled. Billing follows the resulting sample count, capped at 300.
interpolatebooleanNeinBilinear interpolation between the four surrounding grid values. Off returns the nearest grid value unchanged.
include_pointsbooleanNeinReturn the per-point list. Off returns only the summary figures.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "points"
  ],
  "additionalProperties": false,
  "properties": {
    "points": {
      "type": "array",
      "minItems": 2,
      "maxItems": 300,
      "description": "The line, in order. At least two coordinates.",
      "items": {
        "type": "object",
        "required": [
          "lat",
          "lon"
        ],
        "additionalProperties": false,
        "properties": {
          "lat": {
            "type": "number",
            "minimum": -90,
            "maximum": 90,
            "description": "Latitude, WGS 84."
          },
          "lon": {
            "type": "number",
            "minimum": -180,
            "maximum": 180,
            "description": "Longitude, WGS 84."
          },
          "label": {
            "type": "string",
            "maxLength": 80,
            "description": "Optional name, echoed back."
          }
        }
      }
    },
    "resample_m": {
      "type": "number",
      "minimum": 10,
      "maximum": 10000,
      "description": "Insert intermediate points every this many metres along each segment. Without it only the given points are sampled. Billing follows the resulting sample count, capped at 300."
    },
    "interpolate": {
      "type": "boolean",
      "default": true,
      "description": "Bilinear interpolation between the four surrounding grid values. Off returns the nearest grid value unchanged."
    },
    "include_points": {
      "type": "boolean",
      "default": true,
      "description": "Return the per-point list. Off returns only the summary figures."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "points": [
    {
      "lat": 50.73,
      "lon": 7.12,
      "label": "Rhein bei Bonn"
    },
    {
      "lat": 50.6675,
      "lon": 7.2078,
      "label": "Drachenfels"
    }
  ],
  "resample_m": 200
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →