Skip to content
HALOWERK

Ortwerk

bike isochrone

Speeds come from the steady-state cycling power equation P = v·m·g·(sin α + Crr·cos α) + ½·ρ·CdA·v³ with the given rider power and system mass (CdA 0.5 m², air density 1.2 kg/m³, rolling resistance 0.006/0.012/0.025 on smooth/rough/unpaved surfaces from OSM surface/tracktype, descents capped at 30/22/15 km/h; e-bike adds 200 W support up to 25 km/h). Gradients per network edge (≤ 200 m) come from the BKG DGM200 terrain model (200 m grid, © GeoBasis-DE / BKG, dl-de/by-2-0) on HALOWERK's own.

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

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
latnumberYesStart point: latitude (WGS84, Germany).
lonnumberYesStart point: longitude (WGS84, Germany).
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).
rider_power_wintegerNoSustained rider power at the pedals in watts (leisure 70–100, sporty 150–200).
system_mass_kgintegerNoRider plus bike plus luggage in kg.
e_bikebooleanNoPedelec: 200 W motor support up to 25 km/h.
include_geometrybooleanNo
max_pointsintegerNo
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)."
    },
    "minutes": {
      "type": "array",
      "minItems": 1,
      "maxItems": 3,
      "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)."
    },
    "rider_power_w": {
      "type": "integer",
      "minimum": 40,
      "maximum": 400,
      "default": 100,
      "description": "Sustained rider power at the pedals in watts (leisure 70–100, sporty 150–200)."
    },
    "system_mass_kg": {
      "type": "integer",
      "minimum": 40,
      "maximum": 200,
      "default": 90,
      "description": "Rider plus bike plus luggage in kg."
    },
    "e_bike": {
      "type": "boolean",
      "default": false,
      "description": "Pedelec: 200 W motor support up to 25 km/h."
    },
    "include_geometry": {
      "type": "boolean",
      "default": true
    },
    "max_points": {
      "type": "integer",
      "minimum": 200,
      "maximum": 20000,
      "default": 5000
    },
    "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": 47.9959,
  "lon": 7.8522,
  "minutes": [
    15
  ],
  "max_points": 1500
}

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 →