Skip to content
HALOWERK

Signalwerk

osm business match

Searches named businesses (shop, craft, office, healthcare, gastronomy, services) around coordinates, a postcode centroid or a Nominatim-geocoded address in a dated OpenStreetMap Germany extract (Geofabrik, ODbL), or in OSM elements you pass. Scores each candidate by normalised name similarity (legal forms removed, Levenshtein, token overlap), optional street/house number agreement and distance, and returns a verdict match / probable / no_match with the score parts. Contact values (phone,.

POST https://signal.halowerk.com/v1/osm-business-match

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
namestringYesBusiness name as known, e.g. "Bäckerei Schmidt GmbH".
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).
radius_mintegerNoSearch radius around the location.
streetstringNoOptional street of the business for scoring.
housenumberstringNoOptional house number for scoring.
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,
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "Business name as known, e.g. \"Bäckerei Schmidt GmbH\"."
    },
    "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)."
    },
    "radius_m": {
      "type": "integer",
      "minimum": 50,
      "maximum": 3000,
      "default": 300,
      "description": "Search radius around the location."
    },
    "street": {
      "type": "string",
      "maxLength": 100,
      "description": "Optional street of the business for scoring."
    },
    "housenumber": {
      "type": "string",
      "maxLength": 10,
      "description": "Optional house number for scoring."
    },
    "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

{
  "name": "Hofbräuhaus",
  "lat": 48.13763,
  "lon": 11.57994
}

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 →