maps2 für TYPO3

Warum maps2 die Standardlösung für Karten in TYPO3 geworden ist

Jede zweite Unternehmenswebsite braucht eine Kartenanzeige - für Standorte, Filialen, Veranstaltungsorte oder Liefergebiete. In TYPO3 hat sich maps2 als die am weitesten verbreitete Karten-Extension etabliert, weil sie drei Map-Provider gleichzeitig unterstützt: Google Maps, OpenStreetMap und Mapbox. Das bedeutet für Unternehmen echte Wahlfreiheit. Wer Google Maps aus Datenschutzgründen vermeiden will, wechselt auf OpenStreetMap, ohne die Extension austauschen zu müssen.

maps2 geht dabei weit über eine einfache Karteneinbettung hinaus. Die Extension erzeugt Marker direkt aus TYPO3-Datensätzen, unterstützt Clustering bei grossen Markermengen und bietet Routing-Funktionen. Für Redakteure ist das Anlegen neuer Standorte so einfach wie das Erstellen eines normalen TYPO3-Content-Elements.

Typische Einsatzszenarien

Filialfinder für Unternehmen mit 10 bis 500 Standorten. Ein Einzelhandelsunternehmen will auf seiner Website einen interaktiven Filialfinder anbieten. Jede Filiale ist als tt_address-Datensatz oder eigener Record in TYPO3 gespeichert. maps2 liest die Adressen, geocodiert sie (in Kombination mit der Extension geocoordinates) und zeigt sie als Marker auf der Karte. Bei einem Klick auf den Marker öffnet sich ein Popup mit Adresse, Öffnungszeiten und Kontaktdaten. Bei mehr als 50 Markern aktiviert maps2 automatisches Clustering, damit die Karte übersichtlich bleibt.

Immobilien-Websites mit Objektkarten. Makler-Websites auf TYPO3-Basis nutzen maps2 zusammen mit der OpenImmo-Extension. Jedes importierte Immobilienobjekt wird automatisch auf der Karte angezeigt. Nutzer können nach Region filtern und zwischen Karten- und Listenansicht wechseln.

Event- und Veranstaltungsseiten. Kultureinrichtungen, Messen oder Kommunen zeigen Veranstaltungsorte auf einer Karte. maps2 lässt sich mit jeder Extbase-Extension verknüpfen, die Adressdaten enthält - ob cal, tt_address oder eigene Extensions.

Technische Architektur

maps2 ist als Extbase-Extension aufgebaut und nutzt das TYPO3 Plugin-System für die Frontend-Ausgabe. Die zentrale Architekturentscheidung ist die Provider-Abstraktion: Die Extension definiert ein einheitliches Interface für Map-Rendering, das von drei Providern implementiert wird.

• Google Maps Provider: Nutzt die Google Maps JavaScript API v3. Erfordert einen API-Key mit aktiviertem Maps JavaScript API und Geocoding API. Kosten: ca. 7 USD pro 1.000 Kartenaufrufe nach dem kostenlosen Kontingent (28.000/Monat).
• OpenStreetMap Provider: Nutzt Leaflet.js als Rendering-Library mit OSM-Tiles. Keine API-Kosten, keine Registrierung nötig. Einschränkung: Die OSM-Tile-Server haben ein Fair-Use-Limit. Für Websites mit mehr als 50.000 Seitenaufrufen pro Monat empfiehlt sich ein eigener Tile-Server oder ein kommerzieller Anbieter wie MapTiler.
• Mapbox Provider: Premium-Option mit eigenen Kartenstilen. Kosten: 50.000 kostenlose Kartenaufrufe pro Monat, danach 0,50 USD pro 1.000.

Die Extension speichert Kartenkonfigurationen (Zoom, Center, Style) in eigenen Datenbanktabellen. Marker werden über eine Relation zu beliebigen TYPO3-Records erzeugt - maps2 ist nicht auf einen bestimmten Record-Typ festgelegt. Über ein TCA-Override können Entwickler jede Tabelle mit Kartendaten verknüpfen.

Abhängigkeiten: TYPO3 Core (v11+), optional geocoordinates für automatisches Geocoding von Adressen. Für die Frontend-Darstellung benötigt maps2 die JavaScript-API des gewählten Providers. Bei Google Maps wird die API über einen externen Script-Tag geladen; bei OpenStreetMap wird Leaflet.js lokal als Dependency mitgeliefert.

Häufige Probleme und Lösungen

Problem: Karte wird nicht angezeigt, nur grauer Bereich. Bei Google Maps ist in 90% der Fälle der API-Key das Problem. Entweder fehlt er, die Abrechnung ist nicht aktiviert (Google verlangt seit 2018 eine hinterlegte Kreditkarte), oder die erlaubten Domains im API-Key stimmen nicht mit der Website überein. Die Lösung: In der Google Cloud Console prüfen, ob Maps JavaScript API aktiviert ist und der Key für die richtige Domain freigeschaltet wurde.

Problem: Marker erscheinen an falscher Position. Ursache ist häufig ein fehlerhaftes oder fehlendes Geocoding. Wenn Adressen keine Koordinaten haben, versucht maps2 sie über den konfigurierten Geocoding-Service aufzulösen. Bei ungenauen Adressen (z.B. nur Postleitzahl ohne Strasse) landen Marker in der Stadtmitte statt am tatsächlichen Standort. Die Lösung: Koordinaten einmalig über einen Batch-Geocoding-Lauf korrigieren und im Datensatz als feste Werte speichern.

Problem: Performance-Probleme bei mehr als 200 Markern. Die JavaScript-Bibliothek rendert jeden Marker einzeln ins DOM. Ab 200 Markern wird das auf mobilen Geräten spürbar langsam. Die Lösung: Marker-Clustering aktivieren und bei Bedarf serverseitiges Filtering implementieren, sodass nur Marker im aktuellen Kartenausschnitt geladen werden.

Migration und Versions-Kompatibilität

maps2 wird aktiv von Stefan Froemken gepflegt und ist für TYPO3 v11 und v12 LTS verfügbar. Die Kompatibilität mit TYPO3 v13 wird in der Regel zeitnah nach dem LTS-Release hergestellt. Die Extension hat eine stabile API und kaum Breaking Changes zwischen Major-Versionen.

Wer von einer älteren Karten-Extension migriert (z.B. wec_map, od_googlemaps oder ke_daysspecial_map), muss die Datenbankstruktur anpassen. maps2 nutzt eigene Tabellen für die Kartenkonfiguration, die nicht kompatibel mit älteren Extensions sind. Eine Migration umfasst typischerweise: Koordinaten-Export aus der alten Extension, Neuanlage der maps2-Records, Verknüpfung mit bestehenden TYPO3-Datensätzen.

Beim Wechsel von Google Maps auf OpenStreetMap (häufig aus DSGVO-Gründen) muss nur die Provider-Konfiguration in maps2 geändert werden. Templates und Marker-Daten bleiben identisch. Gosign hat diesen Wechsel bei mehreren Kunden in unter einem Tag umgesetzt. Die DSGVO-Motivation dahinter: Google Maps überträgt personenbezogene Daten (IP-Adresse, Browser-Fingerprint) an Google-Server in den USA. Mit OpenStreetMap bleiben die Daten in Europa, und ein Consent-Banner für Kartendienste wird überflüssig. Für Unternehmen, die Karten auf jeder Seite einbinden, verbessert das auch die User Experience, weil die Karte sofort sichtbar ist, ohne dass der Besucher erst dem Cookie-Banner zustimmen muss.