Skip to content
HALOWERK

Ortwerk

meeting point

Runs one Dijkstra search per person (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.

POST https://ort.halowerk.com/v1/meeting-point

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
peoplearrayYesStart points with individual mode (default car).
objectivestringNo
max_minutesintegerNoSearch limit per person.
candidate_categorySee schemaNoOnly meet at OSM points of interest of this category (e.g. rail_station).
candidatesarrayNoOnly meet at one of these points.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "people"
  ],
  "properties": {
    "people": {
      "type": "array",
      "minItems": 2,
      "maxItems": 8,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "lat",
          "lon"
        ],
        "properties": {
          "lat": {
            "type": "number",
            "minimum": 47.2,
            "maximum": 55.1,
            "description": "Person start: latitude (WGS84, Germany)."
          },
          "lon": {
            "type": "number",
            "minimum": 5.8,
            "maximum": 15.1,
            "description": "Person start: longitude (WGS84, Germany)."
          },
          "id": {
            "type": "string",
            "maxLength": 60
          },
          "mode": {
            "type": "string",
            "enum": [
              "car",
              "bike",
              "foot"
            ],
            "default": "car",
            "description": "Travel mode: car, bike (flat profile; terrain-aware: bike-isochrone) or foot."
          }
        }
      },
      "description": "Start points with individual mode (default car)."
    },
    "objective": {
      "type": "string",
      "enum": [
        "sum",
        "max"
      ],
      "default": "sum"
    },
    "max_minutes": {
      "type": "integer",
      "minimum": 5,
      "maximum": 60,
      "default": 60,
      "description": "Search limit per person."
    },
    "candidate_category": {
      "enum": [
        "supermarket",
        "convenience",
        "bakery",
        "drugstore",
        "pharmacy",
        "doctor",
        "dentist",
        "hospital",
        "kindergarten",
        "school",
        "post_office",
        "library",
        "bus_stop",
        "tram_subway_stop",
        "rail_station",
        "playground",
        "park"
      ],
      "description": "Only meet at OSM points of interest of this category (e.g. rail_station)."
    },
    "candidates": {
      "type": "array",
      "minItems": 1,
      "maxItems": 50,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "lat",
          "lon"
        ],
        "properties": {
          "lat": {
            "type": "number",
            "minimum": 47.2,
            "maximum": 55.1,
            "description": "Candidate: latitude (WGS84, Germany)."
          },
          "lon": {
            "type": "number",
            "minimum": 5.8,
            "maximum": 15.1,
            "description": "Candidate: longitude (WGS84, Germany)."
          },
          "id": {
            "type": "string",
            "maxLength": 60
          }
        }
      },
      "description": "Only meet at one of these points."
    }
  }
}

Open original schema

Published input example

{
  "people": [
    {
      "id": "A",
      "lat": 51.4556,
      "lon": 7.0116
    },
    {
      "id": "B",
      "lat": 51.5136,
      "lon": 7.4653
    }
  ],
  "max_minutes": 30,
  "candidate_category": "rail_station"
}

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