(Gültig ab Version 3.9.6)

Allgemeines

Im Frontend ist es möglich in der Mannschafts- und Vereinsübersicht eine Karte mit dem jeweiligen Spiellokal darzustellen.

Diese Funktionalität muss zuerst im Backend in den CLM Einstellungen aktiviert werden: Dazu werden unter Einstellungen -> Externe Dienste die Kartendienste aktviert.

Unter Kartenanzeige stehen nun verschiedene Einstellungen zur Verfügung. In vielen Fällen genügt es unter Vereinsansicht bzw. unter Mannschaftsaufstellung Leaflet oder OpenStreetMap zu aktiveren.

Quickstart

Unter Datenübergabe an Kartendienst sollte "Nur Term2 und Term3" ausgewählt sowie die Kartenanzeige in der Vereinansicht und Mannschaftsaufstellung aktiviert werden (Empfohlen: Leaflet).

Die Adressen der Spiellokale müssen im Format

Name Vereinsheim,

Straße,

Ort

in den Vereins- und Mannschaftseinstellungen angegeben werden. Wichtig ist sind die Komma vor dem Zeilenumbruch, der Name des Vereinsheims kann weggelassen werden.

Unterschied Leaflet und OpenStreetMap

In den Einstellungen Externe Dienste/Kartenanzeige lassen sich unter Vereinsansicht und Mannschaftsaufstellung entweder Leaflet oder OpenstreetMap als Kartendienst aktiveren. Die Unterschiede sind nur kosmetisch. OpenStreetMap ist aus Legacy-Gründen die Standardoption. Die Kartendarstellung mit Leaflet kann etwas flüssiger und moderner wirken.

Funktionsweise Kartendarstellung

Die Adresse des Spiellokals wird von den jeweiligen Mannschaftsführern gesetzt. Die Formatierung der Adresse erfolgt dabei über Kommas für einen Zeilenumbruch, z.B. Spiellokal, Straße, Ort

Damit eine Kartendarstellung möglich ist, muss die Adresse zuerst in Koordinaten umgewandelt werden. Dies geschieht über einen externen Kartendienst, welchem die Adresse übergeben wird und die Koordinaten als Breiten- und Längengrad zurückgibt. Anschließend wird diese Koordinate in der Karte eingezeichnet. Der Kartendienst ist unter "Dienst für Georeferenzierung" einstellbar.

Wird die Karte nicht geladen oder angezeigt, dass die Adresse fehlerhaft ist, so war die Umwandlung der Adresse in Koordinaten nicht erfolgreich. Ursachen ist in den meisten Gründe eine falsche Adressformatierung, dies lässt sich häufig mit der korrekten Einstellung "Datenübergabe an Kartendienst" lösen.

Datenübergabe an Kartendienst

Die meisten Erfolgschancen auf eine erfolgreiche Umwandlung der Adresse in Koordinaten verspricht die Formatierung der Adresse als Strasse, Ort. Um jedoch auch die Angabe des Spiellokals zu ermöglichen, kann mit der Einstellung "Datenübergabe an Kartendienst" angegeben werden, welche Zeilen der Adresse an den Kartendienst übergeben werden.

Zur Veranschaulichung der Funktionsweise folgende Tabelle, bei der in der Spalte "Adresse" die Adresse dargestellt ist, so wie sie der Mannschaftsführer eintragen könnte und in den anderen Spalten wie die Adresse bei den jeweiligen Optionen unter "Datenübergabe an Kartendienst" an den Kartendienst übergeben werden.

Es ist erkennbar, dass bei Option "Nur Term2 und Term3" auch beim Weglassen des Spiellokalnamens trotzdem Straße und Ort übertragen werden. In den meisten Fällen ist "Nur Term2 und Term3" bei Nutzung von OpenStreeMap als Dienst für Georeferenzierung und "Gesamtes Feld" bei Nutzung von Google erfolgsversprechend.

Dienst zur Georeferenzierung

Als Kartendienst für die Umwandlung der Adresse in Koordinaten sind aktuelle OpenStreetMap (https://nominatim.org/) und Googe Geocoding API installiert. OpenStreetMap ist als Standard eingestellt, da für die Nutzung der Google API ein API-Schlüssel notwendig ist.

In den meisten Fällen reicht OpenStreetMap aus, sofern unter "Datenübergabe an Kartendienst" eine der beiden OSM-Optionen (Nur Term2 und Term3 bzw. Nur Term1 und Term2) gewählt werden und die Adressen auch nach diesem Muster eingegegeben werden. OpenStreetMap kann in den wenigsten Fällen mit dem Namen des Vereinsheim etwas anfangen, daher ist darauf zu achten, dass nur die Straße und der Ortsname durch die richtige Wahl der Datenübergabe an OpenStreetMap übergeben werden.

Ansonsten ist auch die Verwendung der Google Geocoding API möglich, welche in nahezu allen Fällen die Adresse richtig umwandeln kann. Für die Erstellung des API-Schlüssel wird auf die Anleitung unter https://developers.google.com/maps/documentation/geocoding/cloud-setup verwiesen. Der API-Schlüssel muss anschließend in den CLM-Einstellungen angegeben werden.

Es ist jedoch zu berücksichtigen, dass bei Verwendung der Google API Kosten anfallen werden, sobald das Freikontigent überschritten ist! Stand April 2022 stellt Google ein Freibudget von 200$ zur Verfügung, welches für die Abfrage von 40000 Koordinaten ausreicht. Die Koordinaten werden jedoch bei jedem Seitenaufruf mit Karte erneut abgefragt. Die Verwendung der Google API liegt unter Berücksichtigung der entsprechenden Kosten im Ermessen des Anwenders.

Die Karte lädt nicht - was kann ich tun?

Bei Verwendung von OpenStreetMap als Dienst zur Georeferenzierung liegt das in den meisten Fallen daran, dass entweder die Adresse nicht im richtigen Format angegeben worden ist oder die Adresse in OpenStreetMap nicht hinterlegt ist.

Zur Behebung des ersten Falls überprüfen, ob unter "Datenübergabe an Kartendienst" die richtige Einstellung angegben worden ist (siehe obige Tabelle) und ob die angegeben Adresse im richtigen Format vorliegt. Sollte die Adresse in OpenStreetMap nicht hinterlegt sein, ist es möglich diese selber einzutragen, siehe https://openstreetmap.de/123/ .

Bei Verwendung von Google zur Georeferenzierung liegt es in den meisten Fällen daran, dass kein API-Schlüssel angegeben worden oder dieser nicht mehr gültig ist. Auch ist es möglich, dass der API-Schlüssel in den Google Cloud Einstellungen auf eine bestimmte IP/Domain beschränkt worden ist.