Skip to content
HALOWERK

Ortwerk

eta from positions

Remaining distance is measured along the supplied route from the projection of the latest position to the route end, or as great-circle distance × detour factor without a route (straight line = lower bound). Speed is the distance driven in the recent window divided by the elapsed time (stops included); the early/late band uses the time-weighted 75th and 25th percentile of segment speeds in that window. ETA = last fix + remaining distance / speed + planned stop minutes. Returns status.

POST https://ort.halowerk.com/v1/eta-from-positions

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
positionsarrayYesRecent GPS fixes with timestamps t, in time order.
destinationobjectYesCustomer location.
routearrayNoOptional planned route [lon, lat] ending at the destination.
detour_factornumberNoFactor applied to the straight-line distance when no route is given (your assumption; 1 = lower bound).
window_minutesintegerNoRecent window for the speed estimate.
stop_minutesintegerNoPlanned stops before arrival, added to the ETA.
arrival_radius_mnumberNoDistance at which the vehicle counts as arrived.
time_windowobjectNoCustomer delivery window.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "positions",
    "destination"
  ],
  "properties": {
    "positions": {
      "type": "array",
      "minItems": 2,
      "maxItems": 5000,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "lat",
          "lon"
        ],
        "properties": {
          "lat": {
            "type": "number",
            "minimum": -90,
            "maximum": 90,
            "description": "Latitude (WGS84)."
          },
          "lon": {
            "type": "number",
            "minimum": -180,
            "maximum": 180,
            "description": "Longitude (WGS84)."
          },
          "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": "Timestamp (ISO 8601 with time zone), optional."
          }
        }
      },
      "description": "Recent GPS fixes with timestamps t, in time order."
    },
    "destination": {
      "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."
        }
      },
      "description": "Customer location."
    },
    "route": {
      "type": "array",
      "minItems": 2,
      "maxItems": 20000,
      "items": {
        "type": "array",
        "minItems": 2,
        "maxItems": 2,
        "items": {
          "type": "number"
        },
        "description": "[longitude, latitude] in WGS84 degrees."
      },
      "description": "Optional planned route [lon, lat] ending at the destination."
    },
    "detour_factor": {
      "type": "number",
      "minimum": 1,
      "maximum": 3,
      "default": 1,
      "description": "Factor applied to the straight-line distance when no route is given (your assumption; 1 = lower bound)."
    },
    "window_minutes": {
      "type": "integer",
      "minimum": 5,
      "maximum": 240,
      "default": 30,
      "description": "Recent window for the speed estimate."
    },
    "stop_minutes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1440,
      "default": 0,
      "description": "Planned stops before arrival, added to the ETA."
    },
    "arrival_radius_m": {
      "type": "number",
      "minimum": 10,
      "maximum": 5000,
      "default": 200,
      "description": "Distance at which the vehicle counts as arrived."
    },
    "time_window": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "from",
        "to"
      ],
      "description": "Customer delivery window.",
      "properties": {
        "from": {
          "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": "Window start."
        },
        "to": {
          "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": "Window end."
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "positions": [
    {
      "t": "2026-10-05T08:00:00Z",
      "lat": 52,
      "lon": 7
    },
    {
      "t": "2026-10-05T08:05:00Z",
      "lat": 52,
      "lon": 7.073
    }
  ],
  "destination": {
    "lat": 52,
    "lon": 7.5
  }
}

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 →