Skip to content
HALOWERK

Mobility, Warnings and Local Data

terrain profile grade threshold exposure

Terrain grade exposure returns the horizontal distance and segment count at or above a requested positive climbing grade. Use it when an agent needs the amount of uphill route exceeding a gradient threshold.

POST https://ort.halowerk.com/v1/terrain-profile-grade-threshold-exposure

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
coordinatesarrayYes
grade_pctnumberYes
Show full input schema
{
  "type": "object",
  "properties": {
    "coordinates": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "number",
          "minimum": -100000000,
          "maximum": 100000000
        },
        "maxItems": 3,
        "minItems": 3
      },
      "maxItems": 160,
      "minItems": 2
    },
    "grade_pct": {
      "type": "number",
      "minimum": 0,
      "maximum": 1000
    }
  },
  "required": [
    "coordinates",
    "grade_pct"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "coordinates": [
    [
      2600000,
      1200000,
      555.5
    ],
    [
      2600250,
      1199850,
      539.5
    ],
    [
      2600500,
      1199700,
      541.4
    ],
    [
      2600750,
      1199550,
      540
    ]
  ],
  "grade_pct": 2
}

Result & documentation

Machine-readable documentation of this hub

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

More endpoints in this hub

All endpoints in this hub โ†’