Skip to content
HALOWERK

Ortwerk

track clean

Works per GPX segment (or on a point list). Steps in order: exact duplicates, points whose time goes backwards, speed spikes (a point is dropped when reaching it and leaving it both exceed max_speed_kmh but skipping it does not; start and end points are checked one-sided), geometric excursions without timestamps (both legs at least spike_min_distance_m while the neighbours lie within a quarter of the detour), elevation spikes replaced by the median of ±3 neighbours, an optional symmetric.

POST https://ort.halowerk.com/v1/track-clean

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
gpxstringNoGPX 1.0/1.1 document text.
pointsarrayNoAlternative to gpx: ordered track points.
max_speed_kmhnumberNoPhysically plausible maximum speed.
spike_min_distance_mnumberNoMinimum leg length for the geometric excursion filter (0 disables it).
elevation_spike_mnumberNoReplace elevations deviating more than this from the local median (0 disables).
smoothingstringNo
smoothing_windowintegerNoOdd window size of the moving average.
simplify_tolerance_mnumberNoDouglas-Peucker tolerance in metres (0 = keep all points).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "gpx": {
      "type": "string",
      "maxLength": 6000000,
      "description": "GPX 1.0/1.1 document text."
    },
    "points": {
      "type": "array",
      "minItems": 2,
      "maxItems": 200000,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "lat",
          "lon"
        ],
        "properties": {
          "lat": {
            "type": "number",
            "minimum": -90,
            "maximum": 90,
            "description": "Latitude in WGS84 degrees."
          },
          "lon": {
            "type": "number",
            "minimum": -180,
            "maximum": 180,
            "description": "Longitude in WGS84 degrees."
          },
          "ele": {
            "type": "number",
            "minimum": -500,
            "maximum": 9000,
            "description": "Elevation in metres (optional)."
          },
          "time": {
            "type": "string",
            "maxLength": 40,
            "description": "ISO 8601 timestamp (optional)."
          }
        }
      },
      "description": "Alternative to gpx: ordered track points."
    },
    "max_speed_kmh": {
      "type": "number",
      "minimum": 1,
      "maximum": 2000,
      "default": 200,
      "description": "Physically plausible maximum speed."
    },
    "spike_min_distance_m": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000,
      "default": 50,
      "description": "Minimum leg length for the geometric excursion filter (0 disables it)."
    },
    "elevation_spike_m": {
      "type": "number",
      "minimum": 0,
      "maximum": 5000,
      "default": 30,
      "description": "Replace elevations deviating more than this from the local median (0 disables)."
    },
    "smoothing": {
      "type": "string",
      "enum": [
        "none",
        "moving_average"
      ],
      "default": "moving_average"
    },
    "smoothing_window": {
      "type": "integer",
      "minimum": 3,
      "maximum": 31,
      "default": 5,
      "description": "Odd window size of the moving average."
    },
    "simplify_tolerance_m": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000,
      "default": 0,
      "description": "Douglas-Peucker tolerance in metres (0 = keep all points)."
    }
  }
}

Open original schema

Published input example

{
  "points": [
    {
      "lat": 52,
      "lon": 7,
      "time": "2026-10-01T10:00:00Z"
    },
    {
      "lat": 52.5,
      "lon": 7,
      "time": "2026-10-01T10:00:01Z"
    },
    {
      "lat": 52.0001,
      "lon": 7,
      "time": "2026-10-01T10:00:02Z"
    },
    {
      "lat": 52.0002,
      "lon": 7,
      "time": "2026-10-01T10:00:03Z"
    }
  ],
  "smoothing": "none"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →