Crea mapas y búsqueda por proximidad
Usa Proximity para filtrar por distancia desde un lugar introducido por el visitante. Usa Map para mostrar las ubicaciones de los resultados y, opcionalmente, limitar los resultados a los límites visibles.
Requisitos previos
- Abre Settings → POM Theme → Integrations → Google Maps.
- Introduce la clave de API del navegador de Google Maps.
- Restringe la clave de producción mediante los referentes HTTP permitidos y las APIs de Google Maps que requiere el sitio.
- Asegúrate de que los elementos publicados tienen coordenadas válidas.
El tema carga la API de Maps solo cuando una faceta de proximidad o de mapa configurada la necesita.
Elige el origen de la ubicación
Para Map, elige Location adapter:
- Latitude/longitude meta pair e introduce Latitude meta key más Longitude meta key;
- Theme locations repeater y elige Primary marker only o All locations.
La latitud debe estar entre -90 y 90; la longitud entre -180 y 180. Con el modo primario, POM usa la primera ubicación primaria válida, o la primera ubicación válida cuando ninguna está marcada como primaria.
Configura la proximidad
Añade una faceta Proximity con un origen Location. Configura:
- Unit en Kilometres o Miles;
- Default radius;
- Minimum radius y Maximum radius;
- Radius step.
El control público usa las sugerencias de lugares de Google, almacena coordenadas y muestra un campo de radio numérico más Clear location. La ordenación por distancia resulta útil después de seleccionar una ubicación.
Configura el mapa
Las opciones importantes incluyen:
- Marker scope: todos los resultados filtrados o la página actual;
- Locations: solo el marcador primario o todas las ubicaciones;
- Initial view y After filtering;
- Bounds filtering: desactivado, Search this area button o automático;
- Other facet changes: preservar o restablecer los límites del mapa;
- Maximum markers, Clustering y la altura del mapa;
- sincronización entre tarjetas y marcadores.
Usa Search this area button cuando los visitantes deban mover el mapa libremente antes de cambiar los resultados. El filtrado automático de límites debe usar un retardo razonable.
Las tarjetas estándar de archivo y de Listings se conectan a los marcadores a través de su identidad de contenido y su contexto de búsqueda. El mismo contenido puede aparecer en más de un área de resultados sin compartir un ID HTML duplicado. Mantén el mapa y sus tarjetas de resultados en el mismo contexto al activar la sincronización.
Verifica la experiencia
Prueba elementos con una ubicación, varias ubicaciones y ninguna ubicación válida. Confirma las interacciones de marcador a tarjeta y de tarjeta a marcador si están activadas, el restablecimiento del área del mapa, el borrado de la proximidad, la ordenación por distancia, la restauración de la URL filtrada, la altura en móvil y el acceso por teclado a las tarjetas de resultados equivalentes.