Zum Inhalt
HALOWERK

Handelswerk

local business

Searches OpenStreetMap through Overpass for businesses of a chosen trade within a radius of a coordinate, and returns each with its name, address, opening hours, phone, website, and the distance from your point, sorted nearest first. Around thirty trades are mapped to the OSM tags that actually hold them, because OSM is indexed by tags and not by free text — a plain word search finds almost nothing there.

POST https://handel.halowerk.com/v1/local-business

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
latitudenumberJaCentre latitude.
longitudenumberJaCentre longitude.
tradestringJaWhich trade to search for.
radius_kmnumberNeinSearch radius in kilometres.
limitintegerNeinHow many results.
require_namebooleanNeinSkip entries with no name — unnamed points are rarely useful.
open_now_onlybooleanNeinOnly entries that declare opening hours (the hours are returned, not evaluated).
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "latitude",
    "longitude",
    "trade"
  ],
  "additionalProperties": false,
  "properties": {
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Centre latitude."
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Centre longitude."
    },
    "trade": {
      "type": "string",
      "enum": [
        "bakery",
        "butcher",
        "supermarket",
        "restaurant",
        "cafe",
        "bar",
        "pharmacy",
        "doctor",
        "dentist",
        "hotel",
        "bank",
        "atm",
        "fuel",
        "car_repair",
        "hairdresser",
        "hardware",
        "electronics",
        "clothes",
        "bookshop",
        "florist",
        "optician",
        "veterinary",
        "school",
        "kindergarten",
        "post_office",
        "laundry",
        "bicycle",
        "craft",
        "office",
        "any_shop"
      ],
      "description": "Which trade to search for."
    },
    "radius_km": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 25,
      "default": 2,
      "description": "Search radius in kilometres."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20,
      "description": "How many results."
    },
    "require_name": {
      "type": "boolean",
      "default": true,
      "description": "Skip entries with no name — unnamed points are rarely useful."
    },
    "open_now_only": {
      "type": "boolean",
      "default": false,
      "description": "Only entries that declare opening hours (the hours are returned, not evaluated)."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "latitude": 52.52,
  "longitude": 13.405,
  "trade": "bakery",
  "radius_km": 0.5,
  "limit": 3
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →