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

Abre la página afectada, las herramientas para desarrolladores del navegador y la consola. Google documenta el formato «Google Maps API error: [ERROR CODE]» e indica la causa y solución de cada código.

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

La facturación no está activada en el proyecto de Google Cloud usado por el mapa. Actívala y recarga la página. Google exige facturación y una clave API o token OAuth para las solicitudes de Maps JavaScript API.

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

Identifica primero el error exacto de la consola. Si Google Cloud no es necesario para el localizador, la aplicación Store Locator ofrece mapas verificados sin clave y un plan gratuito para una ubicación.

Muestra tus tiendas en un mapa sin la API de Google Maps. Más sobre Store Locator ›