Karten-Editor

Die Karten-Verwaltung ermöglicht es dir, interaktive Karten in deine App zu integrieren. Du kannst verschiedene Kartenanbieter konfigurieren, die Darstellung anpassen und DSGVO-konforme Einwilligungsdialoge einrichten.

Übersicht

Das Karten-Modul bietet:

• Mehrere Kartenanbieter: OpenStreetMap (kostenlos), Google Maps, MapTiler
• Marker-Clustering: Nahegelegene Marker werden automatisch gruppiert
• DSGVO-Compliance: Einwilligungsdialog vor dem Laden der Karte
• Flexible Integration: Als eigenständige Seite oder in anderen Modulen

Wer kann die Karten-Einstellungen bearbeiten?

Rolle	Zugriff
Eigentümer	Ja
Administrator	Ja
Moderator	Nein
Redakteur	Nein

---

Karten-Einstellungen öffnen

1. Öffne den Edit Mode (langes Tippen auf die Versionsnummer in den Einstellungen)
2. Gehe zu Module > Karten
3. Tippe auf Karten-Einstellungen öffnen

Der Karten-Editor ist in vier Tabs unterteilt:

• Anbieter - Kartenanbieter aktivieren und konfigurieren
• Anzeige - Zoom, Position und Clustering einstellen
• Datenschutz - DSGVO-Einwilligung konfigurieren
• Steuerung - Bedienelemente ein-/ausblenden

---

Tab: Anbieter

Hier wählst du aus, welche Kartenanbieter in deiner App verfügbar sein sollen.

Standard-Anbieter

Einstellung	Beschreibung
Standard-Anbieter	Der Kartenanbieter, der standardmäßig verwendet wird

Gut zu wissen

Der Standard-Anbieter muss aktiviert sein. Wenn du einen Anbieter deaktivierst, der aktuell Standard ist, wird automatisch ein anderer ausgewählt.

Verfügbare Anbieter

OpenStreetMap

Empfohlen für den Start

Eigenschaft	Details
Kosten	Kostenlos
API-Key	Nicht erforderlich
Datenschutz	Server in Europa, datenschutzfreundlich
Features	Basis-Kartenfunktionen, Marker-Clustering

OpenStreetMap ist Open Source und benötigt keine Registrierung oder API-Keys. Ideal, wenn du schnell starten möchtest.

Google Maps

Hochwertige Karten

Eigenschaft	Details
Kosten	Freikontingent, danach kostenpflichtig
API-Key	Erforderlich
Datenschutz	USA-Server, Einwilligung erforderlich
Features	Detaillierte Karten, Street View

Google Maps bietet hochwertige Kartendarstellung, erfordert aber ein Google Cloud-Konto und einen API-Key.

MapTiler

Stilvolle Designs

Eigenschaft	Details
Kosten	Kostenlose Version verfügbar
API-Key	Erforderlich
Datenschutz	EU-Server verfügbar
Features	Viele Kartenstile, schnelle Ladezeiten

MapTiler bietet moderne Kartenstile und EU-basierte Server. Kostenlose Version reicht für die meisten Apps.

Anbieter aktivieren

1. Öffne den Anbieter-Tab
2. Aktiviere die gewünschten Anbieter mit dem Toggle-Schalter
3. Wähle einen Standard-Anbieter aus
4. Tippe auf Speichern

Nutzer-Optionen

Einstellung	Beschreibung
Nutzer können Anbieter wechseln	Wenn aktiviert, sehen Nutzer einen Button zum Wechseln zwischen den aktivierten Anbietern

---

API-Keys einrichten

Google Maps und MapTiler benötigen API-Keys. Diese werden sicher in Cloud Functions gespeichert.

1. Öffne den Anbieter-Tab
2. Scrolle zum Abschnitt API-Keys
3. Tippe auf API-Keys verwalten
4. Der Setup-Wizard führt dich durch die Einrichtung

Google Maps API-Key erstellen

1. Öffne die Google Cloud Console
2. Erstelle ein neues Projekt oder wähle ein bestehendes
3. Aktiviere die Maps JavaScript API und Maps Static API
4. Gehe zu Anmeldedaten > Anmeldedaten erstellen > API-Schlüssel
5. Kopiere den generierten Key (beginnt mit “AIza…”)
6. Empfohlen: Schränke den Key auf deine App ein
7. Füge den Key im BLOCQ Setup-Wizard ein

Tipp: Key einschränken

Schränke deinen API-Key auf deine App-Bundle-ID ein. Das verhindert Missbrauch und ungewollte Kosten.

MapTiler API-Key erstellen

1. Öffne cloud.maptiler.com
2. Erstelle ein kostenloses Konto oder melde dich an
3. Gehe zu Account > API keys
4. Erstelle einen neuen Key mit einem Namen für deine App
5. Kopiere den Key
6. Füge ihn im BLOCQ Setup-Wizard ein

---

Tab: Anzeige

Hier passt du die Kartendarstellung und das Verhalten an.

Zoom-Einstellungen

Einstellung	Beschreibung	Standardwert
Standard-Zoom	Zoom-Level beim Öffnen der Karte	13
Minimaler Zoom	Wie weit herausgezoomt werden kann	3
Maximaler Zoom	Wie weit hineingezoomt werden kann	18

Zoom-Level erklärt

• 1-5: Kontinente/Länder
• 6-10: Regionen/Städte
• 11-14: Stadtteile/Straßen
• 15-18: Einzelne Gebäude

Standard-Position

Die Position, die beim Öffnen der Karte angezeigt wird:

Einstellung	Beschreibung
Standard Latitude	Breitengrad (z.B. 52.52 für Berlin)
Standard Longitude	Längengrad (z.B. 13.405 für Berlin)
Auf Karte auswählen	Öffnet eine Kartenansicht zur visuellen Auswahl

Position per Karte auswählen

1. Tippe auf Auf Karte auswählen
2. Nutze das Suchfeld, um eine Adresse zu suchen
3. Oder tippe direkt auf die gewünschte Position
4. Die Koordinaten werden automatisch übernommen
5. Bestätige mit Bestätigen

Marker-Clustering

Clustering fasst nahegelegene Marker zu Gruppen zusammen:

Einstellung	Beschreibung	Standardwert
Marker-Clustering	Aktiviert/deaktiviert Clustering	An
Cluster-Radius	Abstand in Pixeln für Gruppierung	80 px
Minimum Marker für Cluster	Ab wie vielen Markern gruppiert wird	2
Cluster animieren	Sanfte Animationen beim Zoomen	An

Wichtig

Clustering ist nur bei OpenStreetMap und MapTiler verfügbar, nicht bei Google Maps.

Marker-Einstellungen

Einstellung	Beschreibung	Standardwert
Marker-Größe	Größe der Marker-Icons in Pixeln	40 px
Eigene Marker verwenden	Theme-basierte Marker statt Standard-Pins	An

---

Tab: Datenschutz

Hier konfigurierst du die DSGVO-konforme Einwilligungsverwaltung.

Warum ist das wichtig?

Kartendienste übertragen Daten an externe Server (z.B. IP-Adressen). Nach DSGVO muss der Nutzer dem zustimmen, bevor die Karte geladen wird.

Einwilligungs-Einstellungen

Einstellung	Beschreibung	Empfehlung
Einwilligung erforderlich	Zeigt Consent-Dialog vor Kartenladung	An
Einwilligung merken	Speichert die Entscheidung für zukünftige Besuche	An
Datenschutz-Link anzeigen	Zeigt Link zur Datenschutzerklärung des Anbieters	An

So sieht es für Nutzer aus

1. Der Nutzer öffnet eine Seite mit Karte
2. Statt der Karte sieht er einen Platzhalter mit Info-Text
3. Er kann auf Zustimmung geben tippen
4. Ein Dialog erklärt, welche Daten übertragen werden
5. Er kann Zustimmen oder Ablehnen wählen
6. Bei Zustimmung wird die Karte geladen

Consent-Text

Der Consent-Text ist mehrsprachig und erklärt dem Nutzer:

• Welcher Kartenanbieter verwendet wird
• Dass die IP-Adresse übertragen wird
• Wie die Daten verarbeitet werden

Automatischer Text

BLOCQ generiert automatisch passende Datenschutz-Texte für jeden Kartenanbieter in Deutsch und Englisch.

---

Tab: Steuerung

Hier legst du fest, welche Bedienelemente auf der Karte angezeigt werden.

Steuerelemente

Element	Beschreibung	Standard
Zoom-Buttons	Plus/Minus-Buttons zum Zoomen	An
Kompass	Zeigt Nordrichtung an	An
Standort-Button	Button zur Navigation zum eigenen Standort	Aus

Wichtig

Diese Steuerelemente funktionieren aktuell nur mit Google Maps. Bei OpenStreetMap und MapTiler werden sie ignoriert.

Geplante Features

Folgende Funktionen sind in Entwicklung und werden in einem zukünftigen Update verfügbar sein:

• Vollbild-Button
• Maßstabs-Anzeige
• Gesten-Einstellungen (Zoom per Pinch, Karte drehen)

---

Karten in der App

Als eigenständige Seite

Die Karte kann als separate Seite in der Navigation angezeigt werden. Dies aktivierst du im Modul-Setup.

In anderen Modulen

Karten können in andere Module integriert werden, z.B.:

• Veranstaltungen: Standort des Events auf Karte
• Kontakt-Seiten: Wegbeschreibung zum Büro
• Immobilien/Locations: Lage auf der Karte

---

Tipps

OpenStreetMap als Start

Beginne mit OpenStreetMap - es ist kostenlos und funktioniert ohne Registrierung. Du kannst später jederzeit Google Maps oder MapTiler hinzufügen.

API-Key-Sicherheit

Deine API-Keys werden sicher in Firebase Cloud Functions gespeichert. Sie sind nicht im App-Code sichtbar und können nicht ausgelesen werden.

DSGVO aktivieren

Lass die Einwilligung aktiviert. Das ist nicht nur rechtlich sicherer, sondern zeigt deinen Nutzern auch, dass du ihre Privatsphäre respektierst.

Standard-Position setzen

Setze die Standard-Position auf einen Ort, der für deine App relevant ist - z.B. deine Stadt oder den Hauptstandort deines Unternehmens.

---

Häufige Fragen

Welchen Kartenanbieter soll ich wählen?

• OpenStreetMap: Ideal für den Start, kostenlos, kein API-Key nötig
• Google Maps: Beste Kartenqualität, aber kostenpflichtig bei hohem Traffic
• MapTiler: Guter Kompromiss, moderne Designs, EU-Server

Entstehen Kosten bei Google Maps?

Google Maps bietet ein monatliches Freikontingent. Für die meisten Apps reicht das aus. Bei sehr hohem Traffic können Kosten entstehen - du siehst diese in der Google Cloud Console.

Muss ich die DSGVO-Einwilligung aktivieren?

Ja, wenn du Nutzer aus der EU hast. Kartendienste übertragen Nutzerdaten (IP-Adressen) an externe Server. Ohne Einwilligung ist das ein DSGVO-Verstoß.

Können Nutzer Marker hinzufügen?

Das hängt vom Modul ab. In der Standard-Kartenansicht können nur Admins Marker hinzufügen. Andere Module (z.B. Veranstaltungen) können eigene Marker-Logik haben.

Warum sehe ich keinen Standort-Button?

Der Standort-Button erfordert Standort-Berechtigungen vom Nutzer. Wenn diese verweigert wurden, funktioniert der Button nicht. Zusätzlich funktioniert er aktuell nur mit Google Maps.

Was passiert, wenn ein Nutzer die Einwilligung ablehnt?

Der Nutzer sieht weiterhin den Platzhalter statt der Karte. Er kann jederzeit erneut auf “Zustimmung geben” tippen, um den Dialog nochmals zu sehen.

---

Weiterführende Themen

Admin-Bereich Übersicht Zurück zur Hauptübersicht

Module Weitere Module aktivieren und konfigurieren