Geo-Modul

Mobile Ansicht einer Karte mit einigen Markern. Ein Marker-Pop-Up ist zu sehen, wo eine Überschrift, ein Bild und ein kurzer Text mit der Adresse zu sehen sind. Unter der Karte ist ein Teil der Ergebnisliste mit den ersten Suchergebnissen zu sehen.

Marker-Pop-Up mit Bild

Einführung

Mit dem Geo-Modul der SimpleSearch können Sie eine Karte zu den Suchergebnissen einblenden. Auf der Karte werden die Orte mit einem Marker gekennzeichnet und beim Anklicken wird ein kleines Pop-up über der Karte geöffnet. Im Pop-up können bspw. Informationen zu dem Ort inkl. eines Bildes angezeigt werden.

Das Geo-Modul eignet sich für alle SimpleSearches, wo beim Ergebnis eine Adresse relevant ist. Das können bspw. Daten zu Veranstaltungen an unterschiedlichen Orten oder Plätze von besonderem Interesse sein.

CSV vorbereiten

Damit eine Karte in der SimpleSearch genutzt werden kann, müssen in der CSV entweder Adressdaten oder WGS84-Koordinaten zu jedem Eintrag hinterlegt werden.

Adressen

Die Adressdaten sollten entweder in einer Spalte ohne Zeilenumbruch, mit Komma getrennt (bspw. Musterweg 1, 12345 Berlin) oder verteilt auf mehrere Spalten (entweder jede Angabe in einer Spalte oder getrennt nach “Straße Hausnummer” und “Postleitzahl Ort”) in der CSV hinterlegt werden.

Die Angaben Straße, Hausnummer und Postleitzahl sollten vollständig sein, damit die Anzeige der Marker möglichst genau erfolgt. Wenn nur eine Straße, aber keine Hausnummer angegeben wird, dann wird der Marker irgendwo auf dieser Straße im Postleitzahlenbereich platziert. Der Ort kann weggelassen werden, wenn es sich nur um Adressen in Berlin handelt.

Ebenfalls sollten Angaben wie “Straße 1 Ecke Straße 2” nicht hinterlegt werden. Bei fehlenden oder ungenauen Angaben kann es passieren, dass die Kodierung der Adresse zu Koordinaten nicht funktioniert und damit kein Marker auf der Karte angezeigt wird.

Koordinaten

Wenn die Angabe einer Adresse zu den Einträgen in der CSV schwierig ist (bspw. bei Veranstaltungen auf größeren Plätzen), können auch WGS84-Koordinaten in der CSV hinterlegt werden. Diese werden dann direkt ausgewertet und auf der Karte als Marker angezeigt.

Dazu wird eine Spalte mit der geografischen Breite (Breitengrad, engl. latitude) und eine zweite mit der geografischen Länge (Längengrad, engl. longitude) benötigt. Beide Angaben müssen in der Dezimalschreibweise mit Punkt getrennt angegeben werden. Für Berliner Koordinaten sieht das dann bspw. so aus:

Breitengrad: 52.51856200
Längengrad: 13.40818474

In Grad, Minuten und Sekunden sieht das so aus: N 52° 31.113720 O 13° 24.491084. Diese Angabe kann die SimpleSearch nicht verarbeiten, daher werden die Koordinaten als Dezimalzahl benötigt.

In der CSV-Datei sollten die Koordinatendaten eine ausreichende Nachkomma-Genauigkeit haben. 8 Nachkommastellen sind die allgemeine Empfehlung beim Umgang mit Koordinaten. 5 Nachkommastellen bedeuten bereits nur noch eine, auf einen Meter genaue Lageangabe.

SimpleSearch-Geo-Modul in der Bearbeitungsansicht. Die Felder werden im Text erklärt.

Geo-Modul

Bearbeitungsansicht

Als Erstes geben Sie entweder die “CSV-Spaltennamen für Breitengrad und Längengrad” oder die “CSV-Spaltenname(n) für Adresse” an. Es darf nur eines der beiden Felder mit Spaltennamen befüllt werden, da das Modul mit zwei Angaben keine Marker generieren kann.

Bitte beachten Sie die Reihenfolge bei der Angabe der Spalten für Breitengrad und Längengrad. Auch wenn manche Koordinatenquellen andersherum aufgebaut sind, müssen im Geo-Modul erst die Spalte mit den Breitengraden und danach die Spalte mit den Längengraden hinterlegt werden, sonst landen Ihre Kartenmarkierungen am anderen Ende der Welt.

Sie können das Feld “Impliziter Bezugsrahmen für Adressen” nutzen, um die Suchgenauigkeit zu erhöhen. Hier können Sie “Berlin” eintragen, wenn sich alle Adressen/Koordinaten in Berlin befinden. Lassen Sie das Feld leer, wenn mindestens eine Adresse/Koordinate außerhalb von Berlin liegt.

Als Nächstes können Sie eine zusätzliche Anzeige der Orte auf der Karte einstellen. Die erhöht die Barrierefreiheit, da in dieser Liste ein Sprung auf den Ort in der Karte möglich ist. Für die Einstellung haben Sie die folgenden Felder zur Verfügung.

Mit “Kartenmarkierungen unter der Karte” stellen Sie ein, ob die Anzeige aktiviert werden soll oder deaktiviert bleibt. Beim “Titel der Kartenmarkierungen” legen Sie fest, wie die Überschrift zu den angezeigten Orten lautet. Wenn Sie mit Koordinaten arbeiten, können Sie mit “CSV-Spaltenname(n) der Adresse zur Anzeige in der Liste” die Spalte mit der Adresse des Ortes hinterlegen, damit diese in der Liste korrekt angezeigt wird. Als Letztes stellen Sie ein, wie die “Darstellung der Liste” aussehen soll. Sie haben die Wahl zwischen “Standard” (die Liste wird normal angezeigt) oder “aufklappbar” (die Nutzer*innen klicken auf den “Titel der Kartenmarkierungen”, um die Liste anzuzeigen).

Ausschnitt der Karte mit einem Marker, darunter die Überschrift "Orte in dieser Karte" mit einem Eintrag, der den Namen und die Adresse des sichtbaren Markers anzeigt und rechts einen Link "In Karte anzeigen" enthält.

Zusätzliche Anzeige der Orte unter der Karte mit der Darstellung "aufklappbar"

Als Nächstes stellen Sie bei “Geografische Suche” ein, ob die Nutzer*innen eine Suche nach einer Adresse oder ihrem aktuellen Standort durchführen können. Wenn hier “an” eingestellt ist, wird in der Suchmaske ein zusätzliches Feld “Umkreissuche (Adresse eingeben)” angeboten.

Zusätzlich können Sie wählen, ob die Nutzer*innen den Suchradius selbst festlegen können (“Suchradius durch Nutzer bestimmbar”) oder ob dieser von Ihnen redaktionell festgelegt wird (“Max. Radius der geografischen Suche”). Ersteres erzeugt ein weiteres Feld in der Suchmaske.

Wenn Sie im zweiten Feld Spalten für eine Adresse hinterlegt haben, müssen Sie die Einstellung “Adressen werden in Koordinaten umgewandelt durch” auf der Standardoption “Google Geokodierer” belassen. Hierbei ist zu beachten, dass die damit entstandenen Koordinaten nicht weitergegeben werden dürfen (siehe: Einrichtung SimpleSearch, Abschnitt Metadaten, Reiter Erweitert). Sind in der CSV bereits Koordinaten für das Geo-Modul hinterlegt, können Sie hier “Keinen” einstellen.

Zum Abschluss können Sie noch Einstellungen zur Frontendansicht der Karte festlegen. Zuerst wählen Sie die “Position der grafischen Darstellung”. Hier kann die Karte über oder unter den Suchergebnissen angezeigt werden. Die Deaktivierung der Karte ist hier ebenfalls möglich. Danach können Sie die Höhe der Karte und die anfängliche Zoomstufe wählen. Zum Abschluss ist es möglich, “Mittelpunkt Koordinaten” zu hinterlegen, wenn bspw. die Punkte auf der Karte sich auf einen Bezirk begrenzen. Bitte nutzen Sie hier ebenfalls die Dezimalschreibweise der Koordinaten, wie bei der CSV.

Welche Informationen im Marker-Pop-Up angezeigt werden, können Sie im Reiter “Weitere Einstellungen” im Abschnitt “Im RSS / Marker Popup sichtbar” festlegen.

Screenshots

  • Suchergebnisse als Ausschnitt der SimpleSearch mit der Überschrift "Ergebnisse der Suche" gefolgt vom Titel der SimpleSearch, der Anzahl der Suchergebnisse mit dem Hinweis, dass die Suche für weniger Ergebnisse eingeschränkt werden kann und einer Karte mit einigen Markern.

    Karte mit Markern - mobile Ansicht

  • Suchergebnisse als Ausschnitt der SimpleSearch mit der Überschrift "Ergebnisse der Suche" gefolgt vom Titel der SimpleSearch, der Anzahl der Suchergebnisse mit dem Hinweis, dass die Suche für weniger Ergebnisse eingeschränkt werden kann und einer Karte mit einigen Markern. Ein Marker-Pop-Up ist zu sehen, wo eine Überschrift, ein kurzer Text mit der Adresse und ein "Mehr"-Link zu sehen sind.

    Marker-Pop-Up nur mit Text - mobile Ansicht

  • Suchergebnisse als Ausschnitt der SimpleSearch beginnend mit der Karte mit einigen Markern. Ein Marker-Pop-Up ist zu sehen, wo eine Überschrift, ein Bild und ein kurzer Text mit der Adresse zu sehen sind. Unter der Karte ist ein Teil der Ergebnisliste mit den ersten Suchergebnissen zu sehen. Die Ergebnisliste besteht aus einem Listenpunkt je Ergebnis, welches in Fettdruck den Namen der Spalte, gefolgt von einem Doppelpunkt und dem Inhalt der Spalte des jeweiligen Datensatzes anzeigt.

    Marker-Pop-Up mit Bild - mobile Ansicht

  • Karte mit einigen Markern

    Karte mit Markern - Desktop-Ansicht

  • Karte mit einigen Markern. Ein Marker-Pop-Up ist zu sehen, wo eine Überschrift, ein kurzer Text mit der Adresse und ein "Mehr"-Link zu sehen sind.

    Marker-Pop-Up nur mit Text - Desktop-Ansicht

  • Karte mit einigen Markern. Ein Marker-Pop-Up ist zu sehen, wo eine Überschrift, ein Bild und ein kurzer Text mit der Adresse zu sehen sind.

    Marker-Pop-Up mit Bild - Desktop-Ansicht

Verwendete Beispiele

Marker auf der Karte fehlen

Beim Hinzufügen von sehr vielen Adressen kann es vorkommen, dass nicht alle Adressen auf der Karte direkt angezeigt werden. Dies hängt damit zusammen, dass die Adressen durch Google in Geo-Koordinaten übersetzt werden. Die Anzahl der Übersetzungen pro Aufruf ist aber begrenzt.

Wenn Marker auf der Karte fehlen, können Sie die Geo-Kodierung mit dem Aufruf der URL der SimpleSearch und einem angehängten Parameter erneut anstoßen. Der Parameter dazu lautet:

?geo_check

Die URL der SimpleSearch sieht dann bspw. so aus:

https://www.berlin.de/template/beispiele/simplesearch/?geo_check (keine funktionierende URL)

Diese URL können Sie mit etwas zeitlichem Abstand auch mehrfach aufrufen, um alle Adressen in Koordinaten übersetzen zu lassen.

Haben Sie auch nach mehreren Aufrufen noch Probleme mit einigen Markern, kontrollieren Sie bitte die jeweiligen Adressen. Bspw. kann die Adresse “Bahnhofstraße 33/ Forum Köpenick, 12555 Berlin” von der Google-Geo-Kodierung nicht kodiert werden. Der Zusatz “Forum Köpenick” ist für Google nicht interpretierbar und muss weggelassen werden.