Skip to content
HALOWERK

Ortwerk

gpx analyze

Parses GPX 1.0/1.1 tracks (or routes) segment by segment, or a point list. Distance: Vincenty inverse on WGS84 per point pair (haversine with the IUGG mean radius 6,371,008.8 m reported alongside), plus 3D distance when elevations exist. Elevation: raw gain/loss and gain/loss after a centred moving average (smoothing_window points) with a hysteresis threshold. Pauses: consecutive point pairs slower than pause_speed_kmh (and gaps between segments) lasting at least min_pause_s. Max speed uses.

POST https://ort.halowerk.com/v1/gpx-analyze

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
gpxstringNoGPX 1.0/1.1 document text.
pointsarrayNoAlternative to gpx: ordered track points.
smoothing_windowintegerNoPoints in the centred moving average applied to elevations (1 = none).
elevation_threshold_mnumberNoHysteresis threshold for counting smoothed climbs and descents.
pause_speed_kmhnumberNoBelow this speed a point pair counts as stopped.
min_pause_sintegerNoMinimum duration of a stop to be reported as pause.
max_speed_window_sintegerNoTime window for the maximum speed.
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."
    },
    "smoothing_window": {
      "type": "integer",
      "minimum": 1,
      "maximum": 51,
      "default": 5,
      "description": "Points in the centred moving average applied to elevations (1 = none)."
    },
    "elevation_threshold_m": {
      "type": "number",
      "minimum": 0,
      "maximum": 20,
      "default": 2,
      "description": "Hysteresis threshold for counting smoothed climbs and descents."
    },
    "pause_speed_kmh": {
      "type": "number",
      "minimum": 0,
      "maximum": 10,
      "default": 1.5,
      "description": "Below this speed a point pair counts as stopped."
    },
    "min_pause_s": {
      "type": "integer",
      "minimum": 5,
      "maximum": 86400,
      "default": 60,
      "description": "Minimum duration of a stop to be reported as pause."
    },
    "max_speed_window_s": {
      "type": "integer",
      "minimum": 1,
      "maximum": 300,
      "default": 10,
      "description": "Time window for the maximum speed."
    }
  }
}

Open original schema

Published input example

{
  "gpx": "<gpx version=\"1.1\" creator=\"x\" xmlns=\"http://www.topografix.com/GPX/1/1\"><trk><trkseg><trkpt lat=\"52.0\" lon=\"7.0\"><ele>40</ele><time>2026-10-01T10:00:00Z</time></trkpt><trkpt lat=\"52.001\" lon=\"7.0\"><ele>42</ele><time>2026-10-01T10:00:20Z</time></trkpt></trkseg></trk></gpx>"
}

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 โ†’