Skip to content
HALOWERK

Signalwerk

opening hours gaps

Takes the businesses of a category within up to 3 km from the dated OpenStreetMap Germany extract (or elements you pass), parses each opening_hours value with the same OSM subset parser as hours-site-vs-osm, and builds a weekday × hour matrix of how many are open. Reports who is open after the evening threshold on weekdays, on Saturday after 14:00, on Sunday and before 7:00, the time bands with zero coverage, and the businesses whose hours are missing or unsupported.

POST https://signal.halowerk.com/v1/opening-hours-gaps

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
latnumberNoLatitude (WGS84) in Germany.
lonnumberNoLongitude (WGS84) in Germany.
addressstringNoPostal address in Germany, geocoded with Nominatim (1 request/s policy, cached).
plzstringNoGerman postcode; its area centroid is used (OSM postcode polygons, daten/H02).
categorystringNoBusiness category preset (mapped to OSM tags).
osm_tagstringNoAlternative: one OSM tag such as shop=bakery.
radius_mintegerNo
evening_fromstringNoEvening threshold (open past this time).
osm_elementsarrayNoOptional: OSM elements in Overpass JSON format (type, id, lat/lon or center, tags) to analyse instead of the built-in extract.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "lat": {
      "type": "number",
      "minimum": 47,
      "maximum": 55.2,
      "description": "Latitude (WGS84) in Germany."
    },
    "lon": {
      "type": "number",
      "minimum": 5.5,
      "maximum": 15.5,
      "description": "Longitude (WGS84) in Germany."
    },
    "address": {
      "type": "string",
      "minLength": 5,
      "maxLength": 200,
      "description": "Postal address in Germany, geocoded with Nominatim (1 request/s policy, cached)."
    },
    "plz": {
      "type": "string",
      "pattern": "^\\d{5}$",
      "description": "German postcode; its area centroid is used (OSM postcode polygons, daten/H02)."
    },
    "category": {
      "type": "string",
      "enum": [
        "bakery",
        "butcher",
        "supermarket",
        "convenience",
        "pharmacy",
        "hairdresser",
        "beauty",
        "florist",
        "optician",
        "hearing_aids",
        "bicycle_shop",
        "car_repair",
        "car_dealer",
        "fuel",
        "restaurant",
        "cafe",
        "fast_food",
        "bar",
        "ice_cream",
        "doctor",
        "dentist",
        "physiotherapist",
        "veterinary",
        "bank",
        "post_office",
        "hotel",
        "fitness",
        "driving_school",
        "electrician",
        "plumber",
        "carpenter",
        "painter",
        "roofer",
        "tailor",
        "laundry",
        "funeral",
        "insurance",
        "estate_agent",
        "tax_advisor",
        "lawyer",
        "shoes",
        "clothes",
        "electronics",
        "hardware",
        "chemist",
        "beverages",
        "books",
        "toys",
        "furniture",
        "pet",
        "jewelry",
        "travel_agency"
      ],
      "description": "Business category preset (mapped to OSM tags)."
    },
    "osm_tag": {
      "type": "string",
      "pattern": "^(shop|craft|amenity|healthcare|office|tourism|leisure)=[a-z0-9_;:-]{1,40}$",
      "description": "Alternative: one OSM tag such as shop=bakery."
    },
    "radius_m": {
      "type": "integer",
      "minimum": 100,
      "maximum": 3000,
      "default": 1500
    },
    "evening_from": {
      "type": "string",
      "pattern": "^(1[6-9]|2[0-3]):[0-5]\\d$",
      "default": "18:00",
      "description": "Evening threshold (open past this time)."
    },
    "osm_elements": {
      "type": "array",
      "maxItems": 3000,
      "description": "Optional: OSM elements in Overpass JSON format (type, id, lat/lon or center, tags) to analyse instead of the built-in extract.",
      "items": {
        "type": "object",
        "required": [
          "type",
          "id",
          "tags"
        ],
        "properties": {
          "type": {
            "enum": [
              "node",
              "way",
              "relation"
            ]
          },
          "id": {
            "type": "integer"
          },
          "lat": {
            "type": "number"
          },
          "lon": {
            "type": "number"
          },
          "center": {
            "type": "object",
            "properties": {
              "lat": {
                "type": "number"
              },
              "lon": {
                "type": "number"
              }
            }
          },
          "tags": {
            "type": "object"
          }
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "lat": 52.2105,
  "lon": 7.0236,
  "category": "pharmacy",
  "radius_m": 2000
}

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 →