11 min de lectura Store Locator
Código HTML de un localizador de tiendas: la guía
Un desglose sencillo de lo que realmente contiene el código HTML de un localizador de tiendas, cómo entran la geolocalización y la búsqueda de productos, y dónde pegarlo en cada plataforma.
El código HTML de un localizador de tiendas es un embed pequeño: un elemento contenedor más una etiqueta de script que carga un mapa, lee tus datos de ubicación y ordena los resultados por distancia. El proveedor de mapas, el método de geolocalización y si los clientes pueden buscar por producto son decisiones separadas que se superponen a esa base.
Un comerciante rara vez escribe este código a mano. Normalmente un plugin, una app o un widget SaaS lo genera y te entrega un solo fragmento para pegar. Saber qué contiene sigue siendo útil, porque muestra qué puedes personalizar.
Qué contiene realmente el fragmento
Tres partes componen un localizador de tiendas funcional. Una biblioteca de mapas renderiza teselas y pines, usando Google Maps, Mapbox, Leaflet con teselas de OpenStreetMap, o el renderizador vectorial propio de un proveedor.
Una fuente de datos de ubicación aporta direcciones y coordenadas, como un array JSON estático, un CSV convertido a JSON, o una llamada a una API en vivo. Una función de distancia, casi siempre la fórmula de haversine sobre latitud y longitud, ordena las ubicaciones según lo lejos que estén del cliente.
La geolocalización necesita un plan B, no solo un aviso
Un localizador puede encontrar al cliente de dos formas. La geolocalización del navegador pide permiso y devuelve una posición precisa del dispositivo, mientras que una estimación basada en IP se salta ese aviso y devuelve en su lugar una estimación a nivel de ciudad.
Los clientes que rechazan ese aviso aun así esperan una búsqueda "cerca de mí" que funcione en el móvil. Una solución práctica es recurrir a una estimación por IP o a una búsqueda manual de dirección cuando el cliente rechaza el aviso.
Dónde pegas realmente el código, según la plataforma
En Shopify, los comerciantes casi nunca pegan HTML. La arquitectura del tema renderiza el contenido de apps de terceros mediante app blocks, que permiten a una app añadir contenido a un tema sin editar su código, así que un localizador se instala como un bloque en vez de un fragmento copiado.
WordPress funciona en cambio mediante su Editor de bloques: un shortcode colocado en cualquier bloque renderiza el localizador en esa página, sin HTML. Nuestra guía de WordPress recorre la configuración completa de un plugin.
Code Block de Squarespace es el lugar documentado para HTML personalizado, aunque el JavaScript y los iframes dentro necesitan el plan Core o superior. Wix ofrece en cambio un elemento Embed HTML para pegar un fragmento, o una app de localizador desde su App Market; nuestra guía de Wix cubre ese camino.
Muchos otros creadores de sitios, incluidos Webflow, BigCommerce y Elementor, ofrecen un elemento de embed o HTML similar para el mismo propósito.
Una checklist antes de construir, código propio o widget
Decidir entre una construcción propia y un widget listo se reduce a cuatro comprobaciones:
- Confirma dónde te deja tu plataforma añadir código personalizado: un bloque, un elemento o una instalación de app.
- Revisa aparte las necesidades de clave del proveedor de mapas; Google Maps y Mapbox exigen cada uno una credencial propia del comerciante, y Google Maps exige además una cuenta de facturación.
- Decide cómo se mantendrán al día los datos de ubicación: ediciones manuales, una hoja sincronizada, o un feed en vivo desde tu plataforma de comercio.
- Prueba la geolocalización en un móvil real con el permiso denegado, no solo concedido, porque ahí es donde suele fallar la búsqueda "cerca de mí".
Qué exige realmente la búsqueda a nivel de producto
Un localizador de tiendas encuentra un lugar. Un localizador de productos responde a una pregunta más concreta, cuál de tus ubicaciones tiene ahora mismo un artículo dado, y eso necesita datos de inventario ligados a cada ubicación, no solo un mapa.
| Requisito | Qué hace | Fuente en Shopify |
|---|---|---|
| Registros de ubicación | Tienda o punto de recogida | Location object |
| Inventario por ubicación | Stock por producto | inventoryLevels |
| Filtro de producto | Mostrar artículo en stock | storeAvailability |
Las filas de ubicación e inventario proceden de la propia Location API de Shopify, y existen sin importar qué app instales. La disponibilidad por ubicación de una variante también se expone de forma nativa mediante el campo storeAvailability de la API Storefront, pensado para la recogida en tienda, aunque convertirlo en un filtro de mapa sigue siendo trabajo de la app.
Haz dos preguntas a un proveedor antes de decidirte:
- ¿La disponibilidad del producto se actualiza automáticamente desde el inventario, o alguien la mantiene a mano?
- ¿Qué muestra la página cuando cada ubicación cercana está agotada?
Conclusiones
Un localizador de tiendas está listo cuando el mapa carga limpio, una prueba de geolocalización con el permiso denegado igual devuelve resultados cercanos, y una búsqueda de producto, si construiste una, excluye una ubicación que sabes agotada. Todo lo demás es pulido.
La mayor parte de esta decisión va de datos, no de diseño: dónde viven tus ubicaciones, qué tan frescas se mantienen, y si la disponibilidad del producto se rastrea en algún sitio cerca del tiempo real. Haz eso bien primero, y el mapa debajo es la parte fácil.
Preguntas frecuentes
¿El código HTML de un localizador de tiendas necesita una clave de API de Google Maps?
Solo si eliges Google Maps, que necesita la propia clave de API del comerciante y una cuenta de facturación. Mapbox necesita en cambio su propio token de acceso, mientras que los mapas construidos sobre datos al estilo OpenStreetMap se saltan la clave por completo.
¿Cuál es la diferencia entre un localizador de tiendas y un localizador de productos?
Un localizador de tiendas muestra dónde están tus ubicaciones. Un localizador de productos muestra cuál de esas ubicaciones tiene ahora mismo un artículo concreto en stock, lo que necesita datos de inventario detrás del mapa.
¿Puedo añadir un localizador de tiendas sin escribir código?
Sí: las apps, plugins y widgets SaaS generan el embed por ti. Progus Store Locator es una opción: un bloque de tema en Shopify, un shortcode en WordPress, una instalación desde el App Market en Wix, gestionado desde la app de Shopify o el panel web; en cualquier otro lugar es un solo fragmento para pegar.
¿La geolocalización siempre pide permiso al cliente?
No. Una estimación basada en IP puede situar a un cliente a nivel de ciudad sin ningún aviso. Eso la convierte en un plan B razonable para clientes que rechazan el aviso del navegador.
Añade un localizador de tiendas a tu web. Más sobre Store Locator ›