API

Basis-URL https://geo-api.getaway.group

Authentifizierung

Alle /api/*-Aufrufe brauchen den Header x-api-key: <KEY>. (Aufrufe aus dieser Web-UI sind als same-origin ausgenommen.)

curl -H "x-api-key: $GEO_API_KEY" \
  "https://geo-api.getaway.group/api/search/point?lat=52.52&lng=13.40&radius=3000"

Suche

GET	/api/search	Unified Fuzzy-Suche über Hotels, POIs, Regionen (inkl. Aliase). q, type?(hotel\|poi\|region), limit?
GET	/api/search/point	Koordinate/Kartenklick → enthaltende Regionen + POIs + Hotels in der Nähe. lat, lng, radius?
GET	/api/search/pois	POIs im Umkreis (PostGIS, <1s). place\|lat/lng, radius?, type?, category?, rank?, preset?
GET	/api/nearby	POIs in der Nähe eines Punkts. lat, lng, type?, category?, radius?, limit?

GET	/api/regions/contains	Regionen, die den Punkt enthalten (verschachtelt, spezifisch→grob). lat, lng
GET	/api/regions/{id}/geometry	Vereinfachte GeoJSON-Geometrie der Region.
GET	/api/regions/{id}/contains	Was in der Region liegt. kind(poi\|hotel\|region), type?, ebene?, limit?
GET	/api/regions/{id}/intersects	Regionen, die sich mit dieser schneiden. ebene?
GET	/api/regions/{id}/aliases	Synonyme/Aliase der Region.

GET

/api/query/hotels

Hotels, die alle Bedingungen erfüllen (UND).

near=typ:meter (mehrfach), region?, thema? (mehrfach), limit?

GET	/api/report/regions	Regionen mit Hotelzahl, 5/10km-Umkreis, Hierarchie, Synonymen. min?, format=json\|csv
GET	/api/report/features	Seen & Berge mit Hotels im 5/10km-Umkreis + Gemeinde. type=see,berg, min?, format=json\|csv

PATCH	/api/entity/{typ}/{id}	Metadaten editieren (source=manual). JSON body
POST	/api/pois	Manuellen Punkt anlegen. JSON body
POST	/api/regions	Manuelle Fläche anlegen. JSON body (GeoJSON)
POST/DELETE	/api/regions/{id}/aliases	Alias hinzufügen/entfernen. JSON {alias}

Vollständige Referenz: docs/pois-api.md im Repo.