9 min de lectura Store Locator
Error de Google Maps API: solución o mapa sin clave
Diagnostica el error de Google Maps API, corrige la clave o facturación, o cambia a un mapa sin clave del comerciante.
Un error de la API de Google Maps suele deberse a una clave ausente o restringida, una API desactivada o la facturación sin activar en el proyecto. Lee primero el código exacto en la consola del navegador y después corrige la configuración o sustituye el mapa por un proveedor que no exija tu propia clave API.
Encuentra el error exacto de la API de Google Maps
No diagnostiques el problema solo por un mapa en blanco. Un contenedor sin altura, un script bloqueado, una clave no válida y la facturación desactivada pueden verse igual, pero requieren soluciones distintas.
Errores habituales y comprobación correcta
BillingNotEnabledMapError
ApiNotActivatedMapError
Maps JavaScript API no está activada en el proyecto asociado a la clave. Actívala en Google Cloud Console y confirma que la página carga la clave del mismo proyecto.
ApiTargetBlockedMapError
La clave no puede usar la API necesaria. Revisa las restricciones y permite Maps JavaScript API. Mantén las restricciones limitadas para proteger la clave, pero incluye cada API que la página utilice.
RefererNotAllowedMapError
La dirección actual del sitio no está en la lista de referentes permitidos. Añade el host de producción y los subdominios necesarios con el patrón HTTP exacto.
InvalidKeyMapError o MissingKeyMapError
La página envía una clave desconocida o ninguna. Revisa la URL del script, el entorno de despliegue, el valor copiado y si un tema o complemento sigue insertando una clave antigua.
¿Corregir Google Maps o eliminar la dependencia de la clave?
Corrige la configuración de Google si el sitio depende de servicios propios de Google o si el error está aislado y entendido. Sustitúyela si el localizador solo necesita búsqueda de ubicaciones, indicaciones, marcadores y un mapa, y el equipo no quiere mantener un proyecto y una clave de Google Cloud.
Una configuración sin clave no implica que todos los proveedores funcionen así. En este localizador, los mapas integrados, dos estilos de OpenStreetMap y tres de Apple Maps funcionan sin clave del comerciante. Google Maps y Mapbox son opcionales y requieren su propia clave.
Opciones de mapa verificadas en el código
- Mapas integrados: cinco estilos sin clave API del comerciante.
- OpenStreetMap: dos estilos sin clave API del comerciante.
- Apple Maps: tres estilos disponibles sin clave API del comerciante.
- Google Maps: cuatro estilos y su catálogo, con la clave del comerciante.
- Mapbox: seis estilos, con la clave del comerciante.
Son diez estilos verificados que no requieren clave del comerciante. La afirmación anterior de más de 23.000 estilos no estaba respaldada por el código y se eliminó.
Cómo migrar un localizador de tiendas
1. Exporta y limpia la lista de ubicaciones
Mantén una fila por ubicación y verifica dirección, nombre, teléfono, horario y sitio web. Elimina duplicados antes de importar.
2. Importa las ubicaciones
El código admite CSV, XLS, XLSX, Numbers y Google Sheets como fuentes. Asigna cada columna al campo correspondiente y revisa las filas rechazadas.
3. Elige un proveedor de mapas
Empieza con un proveedor sin clave si quieres eliminar la administración de la API. Elige Google Maps o Mapbox solo si necesitas su experiencia específica y tienes una clave configurada.
4. Sustituye el localizador anterior
En Shopify, añade el bloque del tema. En WordPress, usa el shortcode [progus-store-locator]. Wix tiene una aplicación dedicada y otros sitios pueden usar el código de inserción alojado.
5. Prueba antes de retirar el mapa anterior
Prueba búsqueda de direcciones, geolocalización alternativa, diseño móvil, indicaciones, clics en marcadores y varias ubicaciones conocidas. Mantén el localizador anterior hasta que el nuevo supere estas comprobaciones.
Para una guía más amplia, consulta el localizador de tiendas sin clave de Google Maps API.
Precios cuando el mapa no necesita clave del comerciante
El plan Free admite una ubicación. En Shopify, Basic cuesta 9,99 USD al mes para 100 ubicaciones, Standard 19,99 USD para 500 y Premium 29,99 USD para 2.000.
Los planes de pago tienen 14 días de prueba y la facturación anual cuesta un 10 % menos. WordPress y Wix también ofrecen Starter por 3,99 USD al mes para 10 ubicaciones.
Son límites del plan de la aplicación, no cuotas de carga del mapa. Hay planes superiores para listas mayores. Consulta la página actual de la plataforma antes de elegir.
Preguntas frecuentes
¿Por qué mi mapa de Google está en blanco?
Revisa la consola. La causa puede ser la facturación, una restricción de API o referente, una clave ausente, un script bloqueado o un contenedor sin altura.
¿Puedo usar un localizador sin clave de Google Maps API?
Sí. Elige un proveedor que no exija tu propia clave. Las opciones integradas, OpenStreetMap y Apple Maps ofrecen diez estilos verificados sin clave.
¿Puedo mantener Google Maps como opción?
Sí. Google Maps sigue disponible, pero requiere tu propia clave de Google Maps API y una configuración correcta de facturación y restricciones.
¿Puedo importar mis ubicaciones actuales?
Sí. Los formatos verificados son CSV, XLS, XLSX, Numbers y Google Sheets.
¿Funciona el mismo localizador fuera de Shopify?
Sí. Las vías verificadas incluyen Shopify, WordPress, Wix y una inserción alojada para otros sitios.
Conclusión
Muestra tus tiendas en un mapa sin la API de Google Maps. Más sobre Store Locator ›