maps2 dla TYPO3

Dlaczego maps2 stało się standardowym rozwiązaniem mapowym w TYPO3

Co druga strona firmowa potrzebuje wyświetlania mapy - dla lokalizacji, oddziałów, miejsc wydarzeń czy obszarów dostawy. W TYPO3 maps2 ugruntowało się jako najbardziej rozpowszechnione rozszerzenie mapowe, ponieważ jednocześnie wspiera trzech dostawców map: Google Maps, OpenStreetMap i Mapbox. Dla firm oznacza to prawdziwą wolność wyboru. Kto chce uniknąć Google Maps ze względu na ochronę danych, przełącza się na OpenStreetMap bez konieczności zmiany rozszerzenia.

maps2 wykracza daleko poza proste osadzanie mapy. Rozszerzenie generuje markery bezpośrednio z rekordów TYPO3, wspiera clustering przy dużych ilościach markerów i oferuje funkcje routingu. Dla redaktorów tworzenie nowych lokalizacji jest tak proste jak tworzenie normalnego elementu treści TYPO3.

Typowe scenariusze zastosowań

Wyszukiwarka oddziałów dla firm z 10 do 500 lokalizacjami. Firma handlowa chce zaoferować na swojej stronie interaktywną wyszukiwarkę oddziałów. Każdy oddział jest przechowywany jako rekord tt_address w TYPO3. maps2 odczytuje adresy, geokoduje je (w połączeniu z rozszerzeniem geocoordinates) i wyświetla jako markery na mapie. Przy kliknięciu na marker otwiera się popup z adresem, godzinami otwarcia i danymi kontaktowymi. Przy więcej niż 50 markerach maps2 automatycznie aktywuje clustering.

Strony nieruchomości z mapami obiektów. Strony pośredników na bazie TYPO3 korzystają z maps2 razem z rozszerzeniem OpenImmo. Każdy zaimportowany obiekt nieruchomości jest automatycznie wyświetlany na mapie.

Strony eventowe i wydarzeń. Instytucje kulturalne, targi czy gminy wyświetlają miejsca wydarzeń na mapie. maps2 można powiązać z każdym rozszerzeniem Extbase zawierającym dane adresowe.

Architektura techniczna

maps2 jest zbudowane jako rozszerzenie Extbase. Centralna decyzja architektoniczna to abstrakcja dostawcy: rozszerzenie definiuje jednolity interfejs renderowania map, implementowany przez trzech providerów. Google Maps Provider korzysta z Google Maps JavaScript API v3 (wymaga klucza API, ok. 7 USD za 1000 wywołań po darmowym limicie). OpenStreetMap Provider korzysta z Leaflet.js z kafelkami OSM (bez kosztów API). Mapbox Provider to opcja premium z własnymi stylami map.

Rozszerzenie przechowuje konfiguracje map we własnych tabelach bazodanowych. Markery są generowane przez relacje do dowolnych rekordów TYPO3 - maps2 nie jest ograniczone do określonego typu rekordu.

Częste problemy i rozwiązania

Mapa nie wyświetla się, tylko szary obszar. Przy Google Maps w 90% przypadków problem dotyczy klucza API. Albo go brakuje, rozliczenie nie jest aktywowane, albo dozwolone domeny w kluczu API nie zgadzają się z witryną. Rozwiązanie: sprawdzenie w Google Cloud Console, czy Maps JavaScript API jest aktywowane i klucz jest odblokowany dla właściwej domeny.

Markery pojawiają się w złej pozycji. Przyczyną jest często błędne lub brakujące geokodowanie. Rozwiązanie: jednorazowa korekta współrzędnych przez batch geocoding i zapisanie w rekordzie jako stałe wartości.

Problemy wydajnościowe przy ponad 200 markerach. Biblioteka JavaScript renderuje każdy marker osobno w DOM. Od 200 markerów na urządzeniach mobilnych staje się to odczuwalnie wolne. Rozwiązanie: aktywacja Marker-Clustering i w razie potrzeby implementacja serwerowego filtrowania.

Migracja i kompatybilność wersji

maps2 jest aktywnie utrzymywane przez Stefana Froemkena i jest dostępne dla TYPO3 v11 i v12 LTS. Kompatybilność z TYPO3 v13 jest z reguły zapewniana wkrótce po wydaniu LTS. Rozszerzenie ma stabilne API i prawie żadnych zmian łamiących między głównymi wersjami.

Przy przejściu z Google Maps na OpenStreetMap (często z motywacji RODO/UODO) wystarczy zmienić konfigurację dostawcy w maps2. Szablony i dane markerów pozostają identyczne. Gosign zrealizował tę zmianę u kilku klientów w mniej niż jeden dzień. Motywacja ochrony danych: Google Maps przesyła dane osobowe (adres IP, fingerprint przeglądarki) do serwerów Google w USA. Z OpenStreetMap dane pozostają w Europie, a baner zgody na usługi mapowe staje się zbędny.

Gosign standardowo łączy maps2 z geocoordinates, by dostarczyć kompletny stos wyszukiwarki oddziałów: wprowadzanie adresu przez redaktora, automatyczne geokodowanie w tle, wyświetlanie mapy z markerem i popupem we frontendzie, wyszukiwanie w okolicy z wprowadzaniem kodu pocztowego dla odwiedzającego. Stos jest konfigurowany w 2 do 3 dni i pokrywa wymagania 90% wszystkich projektów wyszukiwarek oddziałów.