Skip to content
HALOWERK

Ortwerk

idle detect

Stay-point detection (anchor point, radius, minimum duration): consecutive fixes within the radius of the first fix and not moving (speed at or below the moving threshold if speed is given) form a stop from the first to the last stationary fix. Each interval inside a stop is attributed to the ignition state of its starting fix (on = engine idling, off = parked, missing = unknown); gaps longer than max_gap_s are flagged. Stops are matched to caller-supplied sites (circles); others are.

POST https://ort.halowerk.com/v1/idle-detect

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
positionsarrayYesGPS fixes in time order.
radius_mnumberNoStay radius around the first fix of a stop.
min_duration_sintegerNoMinimum stop duration.
moving_speed_kmhnumberNoA fix with a higher reported speed counts as moving.
max_gap_sintegerNoData gaps longer than this inside a stop are flagged.
sitesarrayNoKnown places (depot, customers) as circles.
idle_fuel_l_per_hnumberNoYour assumption for fuel use while idling (litres per hour); without it no fuel estimate is made.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "positions"
  ],
  "properties": {
    "positions": {
      "type": "array",
      "minItems": 2,
      "maxItems": 20000,
      "description": "GPS fixes in time order.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "t",
          "lat",
          "lon"
        ],
        "properties": {
          "t": {
            "type": "string",
            "maxLength": 40,
            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,3})?)?(?:Z|[+-]\\d{2}:\\d{2})$",
            "description": "Fix time (ISO 8601 with time zone)."
          },
          "lat": {
            "type": "number",
            "minimum": -90,
            "maximum": 90,
            "description": "Latitude (WGS84)."
          },
          "lon": {
            "type": "number",
            "minimum": -180,
            "maximum": 180,
            "description": "Longitude (WGS84)."
          },
          "speed_kmh": {
            "type": "number",
            "minimum": 0,
            "maximum": 400,
            "description": "Speed reported by the device, if available."
          },
          "ignition": {
            "type": "boolean",
            "description": "Ignition/engine on, if available."
          }
        }
      }
    },
    "radius_m": {
      "type": "number",
      "minimum": 5,
      "maximum": 2000,
      "default": 50,
      "description": "Stay radius around the first fix of a stop."
    },
    "min_duration_s": {
      "type": "integer",
      "minimum": 30,
      "maximum": 86400,
      "default": 300,
      "description": "Minimum stop duration."
    },
    "moving_speed_kmh": {
      "type": "number",
      "minimum": 0,
      "maximum": 50,
      "default": 3,
      "description": "A fix with a higher reported speed counts as moving."
    },
    "max_gap_s": {
      "type": "integer",
      "minimum": 60,
      "maximum": 86400,
      "default": 900,
      "description": "Data gaps longer than this inside a stop are flagged."
    },
    "sites": {
      "type": "array",
      "maxItems": 500,
      "description": "Known places (depot, customers) as circles.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "name",
          "lat",
          "lon",
          "radius_m"
        ],
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120,
            "description": "Site name."
          },
          "lat": {
            "type": "number",
            "minimum": -90,
            "maximum": 90,
            "description": "Centre latitude."
          },
          "lon": {
            "type": "number",
            "minimum": -180,
            "maximum": 180,
            "description": "Centre longitude."
          },
          "radius_m": {
            "type": "number",
            "exclusiveMinimum": 0,
            "maximum": 10000,
            "description": "Site radius in metres."
          }
        }
      }
    },
    "idle_fuel_l_per_h": {
      "type": "number",
      "minimum": 0,
      "maximum": 20,
      "description": "Your assumption for fuel use while idling (litres per hour); without it no fuel estimate is made."
    }
  }
}

Open original schema

Published input example

{
  "positions": [
    {
      "t": "2026-10-05T08:00:00Z",
      "lat": 52,
      "lon": 7
    },
    {
      "t": "2026-10-05T08:06:00Z",
      "lat": 52,
      "lon": 7,
      "ignition": true
    },
    {
      "t": "2026-10-05T08:07:00Z",
      "lat": 52.01,
      "lon": 7
    }
  ],
  "min_duration_s": 300
}

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