Skip to content
HALOWERK

Ortwerk

isochrone

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 at most 200 m long). Profiles: car uses maxspeed tags (or class defaults such as 30 km/h residential, 70 km/h primary, 120 km/h motorway) at 85 % as free-flow speed with oneways; bike 18/14/10 km/h on smooth/rough/unpaved surfaces with cycling oneways and bicycle access rules; foot 4.8 km/h on all.

POST https://ort.halowerk.com/v1/isochrone

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
latnumberYesStart point: latitude (WGS84, Germany).
lonnumberYesStart point: longitude (WGS84, Germany).
modestringNoTravel mode: car, bike (flat profile; terrain-aware: bike-isochrone) or foot.
minutesarrayYesTime limits in minutes (1–60; car, bike and foot up to 60).
directionstringNo"from": travel away from the point; "to": travel towards the point (oneways reversed).
include_geometrybooleanNoReturn the polygons (false: only areas and check points).
max_pointsintegerNoVertex budget per polygon; larger areas are coarsened.
targetsarrayNoOptional check points whose travel time is reported.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "lat",
    "lon",
    "minutes"
  ],
  "properties": {
    "lat": {
      "type": "number",
      "minimum": 47.2,
      "maximum": 55.1,
      "description": "Start point: latitude (WGS84, Germany)."
    },
    "lon": {
      "type": "number",
      "minimum": 5.8,
      "maximum": 15.1,
      "description": "Start point: longitude (WGS84, Germany)."
    },
    "mode": {
      "type": "string",
      "enum": [
        "car",
        "bike",
        "foot"
      ],
      "default": "car",
      "description": "Travel mode: car, bike (flat profile; terrain-aware: bike-isochrone) or foot."
    },
    "minutes": {
      "type": "array",
      "minItems": 1,
      "maxItems": 4,
      "uniqueItems": true,
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 60
      },
      "description": "Time limits in minutes (1–60; car, bike and foot up to 60)."
    },
    "direction": {
      "type": "string",
      "enum": [
        "from",
        "to"
      ],
      "default": "from",
      "description": "\"from\": travel away from the point; \"to\": travel towards the point (oneways reversed)."
    },
    "include_geometry": {
      "type": "boolean",
      "default": true,
      "description": "Return the polygons (false: only areas and check points)."
    },
    "max_points": {
      "type": "integer",
      "minimum": 200,
      "maximum": 20000,
      "default": 5000,
      "description": "Vertex budget per polygon; larger areas are coarsened."
    },
    "targets": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "lat",
          "lon"
        ],
        "properties": {
          "lat": {
            "type": "number",
            "minimum": 47.2,
            "maximum": 55.1,
            "description": "Check point: latitude (WGS84, Germany)."
          },
          "lon": {
            "type": "number",
            "minimum": 5.8,
            "maximum": 15.1,
            "description": "Check point: longitude (WGS84, Germany)."
          },
          "id": {
            "type": "string",
            "maxLength": 60
          }
        }
      },
      "description": "Optional check points whose travel time is reported."
    }
  }
}

Open original schema

Published input example

{
  "lat": 52.52,
  "lon": 13.405,
  "mode": "foot",
  "minutes": [
    5,
    10
  ],
  "max_points": 1000
}

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 →