Umkreissuche

Die Filterregel „Umkreissuche“ (Paket filter_perimetersearch) filtert Items anhand ihrer geografischen Position. Besucher geben eine Adresse oder Koordinaten ein und wählen einen Suchradius; die Filterregel ermittelt alle Items, deren Geokoordinaten (Latitude/Longitude) innerhalb des angegebenen Umkreises liegen.

Voraussetzung ist, dass die Items Geokoordinaten in zwei separaten Dezimal-Attributen (Latitude und Longitude) gespeichert haben. Für die Geocodierung von Adressen in Koordinaten werden externe Lookup-Dienste verwendet (z. B. OpenStreetMap/Nominatim, Google Maps API).

Siehe auch

Detaillierte Dokumentation zur Umkreissuche: Umkreissuche

Installation

Die Filterregel wird über den Contao Manager oder Composer installiert:

composer require metamodels/filter_perimetersearch

Einstellungen beim Anlegen der Filterregel

Einstellung	Beschreibung
Typ	Auswahl des Filterregeltyps – hier: „Umkreissuche“.
Aktiviert	Aktiviert oder deaktiviert diese Filterregel.
Kommentar	Freitextfeld zur Beschreibung des Zwecks dieser Filterregel.
Datenmodus	Legt fest, wie die Geokoordinaten der Items gespeichert sind: Einzelnes Attribut – Die Koordinaten sind in einem einzigen kombinierten Attribut gespeichert (z. B. „lat,long“ als Text). Zusätzliche Option: Attribut (Einzeln) – Auswahl des Attributs. Zwei Attribute – Latitude und Longitude sind in zwei separaten Attributen gespeichert. Zusätzliche Optionen: Erstes Attribut (Lat) und Zweites Attribut (Long).
URL-Parameter	Der Schlüssel (Key) des URL-Parameters für die Adress-/Koordinateneingabe.

Einstellungen für das Frontend-Widget

Einstellung	Beschreibung
URL-Parameter	Der Schlüssel (Key) des URL-Parameters für die Übergabe des Filterwerts. Ohne Angabe wird der Spaltenname des Attributs verwendet. Mit auto_item wird nur der Wert – ohne Schlüssel – in die URL eingebaut.
URL-Typ für den Parameter	Legt fest, ob der Parameter als Slug (sprechende URL), als GET-Parameter übergeben wird (ab MM 2.4) - siehe SEO
Label	Beschriftung des Adress-Eingabefelds.
Platzhalter	Platzhaltertext im Adress-Eingabefeld.
Template (Adressfeld)	Template für die Ausgabe des Adress-Eingabefelds.
Label (Umkreis)	Beschriftung des Umkreis-Auswahl-Widgets.
Template (Umkreis)	Template für die Ausgabe des Umkreis-Widgets. Standard: mm_filteritem_default.
Umkreismodus	Legt fest, wie der Suchradius bestimmt wird: Frei – Der Besucher gibt den Radius als Zahlenwert ein. Zusätzliche Option: Platzhalter (Umkreis). Vorgabe – Ein fester Radius wird verwendet. Zusätzliche Option: Radius-Vorgabe (Kilometerwert). Auswahl – Der Besucher wählt aus einer vordefinierten Liste von Radien. Zusätzliche Option: Radius-Auswahl (MCW-Tabelle mit Wert und Standard-Flag).
Ländermodus	Legt fest, ob und wie ein Land für die Geocodierung vorgegeben wird: Kein Land – Kein Länderfilter. Vorgabe – Festes Land (ISO-Code). Zusätzliche Option: Land-Vorgabe. GET-Parameter – Das Land wird über einen URL-Parameter übergeben. Zusätzliche Option: Land-GET-Parameter.
Lookup-Dienst	Konfiguration des Geocodierungsdienstes (MCW-Tabelle): Dienst – Auswahl des Geocodierungsdienstes (z. B. Nominatim, Google Maps). API-Token – Optionaler API-Schlüssel für kostenpflichtige Dienste.

Passende Attribute

Die Filterregel „Umkreissuche“ benötigt Geokoordinaten in Dezimalform:

• Dezimal (für Latitude und Longitude separat)

Zusätzlich kann das Attribut Geo-Entfernung für die Anzeige und Sortierung nach Entfernung verwendet werden.