Skip to content
HALOWERK

Ortwerk

surroundings profile

Searches a dated OpenStreetMap extract for Germany (Geofabrik germany-latest.osm.pbf, data until 2026-11-12, filtered with osmium and stored locally; ODbL 1.0) for 17 everyday categories around the point. Areas (e.g. school grounds, parks) are represented by their area-weighted centroid; objects mapped twice (point and area with the same name less than 150 m apart) are counted once. Returns per category the number within the radius, the nearest object with straight-line distance and up to.

POST https://ort.halowerk.com/v1/surroundings-profile

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
latnumberYesLatitude in WGS84 decimal degrees (Germany).
lonnumberYesLongitude in WGS84 decimal degrees (Germany).
radius_mintegerNoSearch radius in metres (100–3000).
categoriesarrayNoOptional subset of categories; default all.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "lat",
    "lon"
  ],
  "properties": {
    "lat": {
      "type": "number",
      "minimum": 47.2,
      "maximum": 55.1,
      "description": "Latitude in WGS84 decimal degrees (Germany)."
    },
    "lon": {
      "type": "number",
      "minimum": 5.8,
      "maximum": 15.1,
      "description": "Longitude in WGS84 decimal degrees (Germany)."
    },
    "radius_m": {
      "type": "integer",
      "minimum": 100,
      "maximum": 3000,
      "default": 1000,
      "description": "Search radius in metres (100–3000)."
    },
    "categories": {
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "maxItems": 17,
      "items": {
        "enum": [
          "school",
          "kindergarten",
          "doctor",
          "dentist",
          "pharmacy",
          "hospital",
          "supermarket",
          "convenience",
          "bakery",
          "drugstore",
          "post_office",
          "library",
          "bus_stop",
          "tram_subway_stop",
          "rail_station",
          "playground",
          "park"
        ]
      },
      "description": "Optional subset of categories; default all."
    }
  }
}

Open original schema

Published input example

{
  "lat": 50.94128,
  "lon": 6.95826,
  "radius_m": 500,
  "categories": [
    "school",
    "supermarket",
    "pharmacy"
  ]
}

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 →