maps2 para TYPO3

Por qué maps2 se ha convertido en la solución estándar para mapas en TYPO3

Una de cada dos webs corporativas necesita una visualización de mapas - para sedes, sucursales, lugares de eventos o zonas de reparto. En TYPO3, maps2 se ha establecido como la extensión de mapas más extendida porque soporta tres proveedores simultáneamente: Google Maps, OpenStreetMap y Mapbox. Eso significa libertad de elección real. Quien quiera evitar Google Maps por razones de privacidad cambia a OpenStreetMap sin necesidad de sustituir la extensión.

maps2 va mucho más allá de una simple incrustación de mapas. La extensión genera marcadores directamente desde registros TYPO3, soporta clustering para grandes cantidades de marcadores y ofrece funciones de routing.

Escenarios de uso habituales

Buscador de sucursales para empresas con 10 a 500 sedes. Una empresa minorista quiere ofrecer un buscador de ubicaciones interactivo en su web. Cada sucursal está almacenada como registro tt_address o record propio en TYPO3. maps2 lee las direcciones, las geocodifica (en combinación con la extensión geocoordinates) y las muestra como marcadores en el mapa. Al hacer clic en un marcador se abre un popup con dirección, horarios y datos de contacto. Con más de 50 marcadores, maps2 activa clustering automático.

Webs inmobiliarias con mapas de objetos. Webs de agencias inmobiliarias basadas en TYPO3 usan maps2 junto con la extensión OpenImmo. Cada inmueble importado se muestra automáticamente en el mapa.

Páginas de eventos y actividades. Instituciones culturales, ferias o ayuntamientos muestran los lugares de celebración en un mapa. maps2 se vincula con cualquier extensión Extbase que contenga datos de dirección.

Arquitectura técnica

maps2 está construida como extensión Extbase y usa el sistema de plugins TYPO3 para la salida frontend. La decisión arquitectónica central es la abstracción de proveedores: la extensión define una interfaz unificada para el renderizado de mapas implementada por tres proveedores. Google Maps Provider (API JavaScript v3, requiere API key, aprox. 7 USD por 1.000 llamadas tras la cuota gratuita), OpenStreetMap Provider (Leaflet.js, sin costes API, sin registro) y Mapbox Provider (opción premium con estilos propios).

La extensión almacena configuraciones de mapa en tablas de base de datos propias. Los marcadores se generan vía relación con cualquier registro TYPO3 - maps2 no está limitada a un tipo de registro específico.

Problemas frecuentes y soluciones

El mapa no se muestra, solo un área gris. Con Google Maps, en el 90 % de los casos el problema es el API key. O falta, la facturación no está activada (Google exige desde 2018 una tarjeta de crédito vinculada), o los dominios permitidos en el API key no coinciden con la web. Solución: verificar en la Google Cloud Console que Maps JavaScript API esté activada y el key esté habilitado para el dominio correcto.

Los marcadores aparecen en posición incorrecta. La causa suele ser una geocodificación defectuosa o ausente. Si las direcciones no tienen coordenadas, maps2 intenta resolverlas vía el servicio de geocodificación configurado. Con direcciones imprecisas (por ejemplo, solo código postal sin calle) los marcadores aterrizan en el centro de la ciudad. Solución: corregir coordenadas mediante un batch de geocodificación y almacenarlas como valores fijos.

Problemas de rendimiento con más de 200 marcadores. La librería JavaScript renderiza cada marcador individualmente en el DOM. A partir de 200 marcadores se nota en dispositivos móviles. Solución: activar clustering y, si es necesario, implementar filtrado en servidor para cargar solo marcadores del área visible del mapa.

Migración y compatibilidad de versiones

maps2 se mantiene activamente por Stefan Froemken y está disponible para TYPO3 v11 y v12 LTS. La extensión tiene una API estable y apenas breaking changes entre versiones major.

Al cambiar de Google Maps a OpenStreetMap (frecuente por motivos RGPD), solo hay que cambiar la configuración del proveedor en maps2. Plantillas y datos de marcadores permanecen idénticos. La motivación RGPD: Google Maps transmite datos personales (dirección IP, huella del navegador) a servidores de Google en EE.UU. Con OpenStreetMap los datos permanecen en Europa, conforme a los criterios de la AEPD, y un banner de consentimiento para servicios de mapas se vuelve innecesario. Para empresas que integran mapas en cada página, esto mejora también la experiencia de usuario porque el mapa es visible inmediatamente sin que el visitante tenga que aceptar primero el banner de cookies.