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-positionsInputs
| Field | Type | Required | Description |
|---|---|---|---|
| positions | array | Yes | Recent GPS fixes with timestamps t, in time order. |
| destination | object | Yes | Customer location. |
| route | array | No | Optional planned route [lon, lat] ending at the destination. |
| detour_factor | number | No | Factor applied to the straight-line distance when no route is given (your assumption; 1 = lower bound). |
| window_minutes | integer | No | Recent window for the speed estimate. |
| stop_minutes | integer | No | Planned stops before arrival, added to the ETA. |
| arrival_radius_m | number | No | Distance at which the vehicle counts as arrived. |
| time_window | object | No | Customer 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."
}
}
}
}
}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
- Ortwerk0.01 USDC
area coverage
POSThttps://ort.halowerk.com/v1/area-coverageRuns one multi-source Dijkstra from all origins (Routing runs on HALOWERK's own graph of the German road and path network built from OpenStreetMap (Geofabrik germany-latest.osm.pbf, data until 2026-11-12, ODbL 1.0; 25 million nodes, edges a
- Ortwerk0.004 USDC
autobahn roadworks
POSThttps://ort.halowerk.com/v1/autobahn-roadworksFetches live roadworks (long- and short-term) and closures per motorway from the public Autobahn App API of Die Autobahn GmbH des Bundes (no key; https://verkehr.autobahn.de/o/autobahn). The free-text periods are parsed into concrete interv
- Ortwerk0.004 USDC
avalanche bulletin
POSThttps://ort.halowerk.com/v1/avalanche-bulletinFresh official WSL SLF CAAMLv6 JSON for one Swiss warning region, in de/en/fr/it with explicit actual-language fallback. Includes the complete unmodified bulletin, all elevation/aspect/time distinctions, publication and validity times, sour