maps2 dla TYPO3

Dlaczego maps2 należy do standardowych rozwiązań mapowych 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 jedno z najpopularniejszych rozszerzeń mapowych, ponieważ jednocześnie wspiera dwóch dostawców map: Google Maps i OpenStreetMap. 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 przy Google Maps clustering dla dużych ilości markerów i rysuje trasy, obszary i promienie. 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 (przez wbudowaną w maps2 usługę geokodowania Google lub OpenStreetMap) i wyświetla jako markery na mapie. Przy kliknięciu na marker otwiera się popup z adresem, godzinami otwarcia i danymi kontaktowymi. Przy wielu markerach w Google Maps można włączyć 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 dwóch 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). Adres kafelków mapy można dowolnie ustawić, np. na własny serwer lub komercyjnego dostawcę.

Rozszerzenie przechowuje punkty, trasy, obszary i promienie we własnej tabeli, a zoom i rozmiar mapy w ustawieniach wtyczki. 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 ma osobną serię dla każdej wersji LTS: 10.x dla v11, 11.x dla v12, 12.x dla v13 i 13.x dla v14. Główne wersje przynoszą jednak zmiany, np. przejście z wtyczek na elementy treści w 12.0.0; dokumentacja opisuje każdy krok wraz z upgrade wizardem.

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 takie jak adres IP do Google, także na serwery poza UE. Z kafelkami OpenStreetMap z własnego serwera dane nie trafiają do nikogo innego, 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.