Guías y tutoriales2026-03-15·9 min de lectura

Guía: Configuración de la Clave API de Google Maps (2025)

Por Ibrahim DemolCEO IBLeadActualizado el 12 de junio de 2026

Obtener una clave API de Google Maps es el primer paso para cualquier desarrollador o comercial que quiera incrustar mapas, obtener datos de ubicación o construir características basadas en ubicación. Esta guía sobre la configuración de la clave API de Google Maps cubre cada paso, desde crear tu cuenta de Google Cloud hasta asegurar tu clave y evitar cargos inesperados.

Sin rodeos. Solo los pasos exactos que necesitas.

Por qué necesitas una clave API de Google Maps

La clave API es tu token de autenticación. Sin ella, Google no proporcionará los mosaicos del mapa, los resultados de geocodificación o los datos de direcciones a tu aplicación.

Esto es lo que realmente hace la clave:

Otorga acceso a los servicios de la Plataforma de Google Maps (Maps JavaScript API, Geocoding API, Places API, etc.)
Rastrea tu uso para que Google pueda aplicar el nivel de facturación correcto
Se vincula a tu cuenta de facturación — los cargos solo se aplican después de que superes el crédito mensual gratuito ($200/mes a partir de 2025)
Te permite restringir el acceso para que solo tu dominio o aplicación puedan usar la clave

Cualquier proyecto que toque Google Maps necesita una. No hay forma de evitarlo.

Paso 1: Crea una cuenta de Google Cloud Platform

Ve a console.cloud.google.com. Inicia sesión con tu cuenta de Google, o crea una si no tienes.

Si es tu primera vez, Google te guiará a través de un breve proceso de incorporación. Necesitarás aceptar los Términos de Servicio y configurar una cuenta de facturación (más sobre eso en el Paso 4).

Las nuevas cuentas obtienen un crédito gratuito de $300 válido por 90 días. Eso es independiente del crédito mensual de $200 para Maps.

Paso 2: Crea un nuevo proyecto

Cada clave API vive dentro de un proyecto. Los proyectos mantienen tus claves, facturación y datos de uso organizados.

Haz clic en el menú desplegable de proyectos en la parte superior de la Consola GCP (normalmente muestra "Mi Primer Proyecto" o similar)
Haz clic en Nuevo Proyecto
Dale un nombre claro, algo como "Integración de Mapas" o el nombre de tu empresa
Haz clic en Crear

La consola cambiará automáticamente a tu nuevo proyecto. Todos los siguientes pasos ocurren dentro de este proyecto.

Paso 3: Habilita las APIs de Google Maps que necesitas

No todas las APIs de Maps están habilitadas por defecto. Debes activar cada una que planeas usar.

En la barra lateral izquierda, ve a APIs y Servicios → Biblioteca
Busca "Maps"
Haz clic en la API que necesitas — para la mayoría de los proyectos web, comienza con Maps JavaScript API
Haz clic en Habilitar

Repite para cualquier otra API que necesite tu proyecto. Las más comunes incluyen:

API	Caso de uso
Maps JavaScript API	Mapas interactivos en sitios web
Geocoding API	Convertir direcciones en coordenadas
Places API	Buscar negocios y PDI
Directions API	Planificación de rutas
Distance Matrix API	Tiempo de viaje entre múltiples puntos

Si no estás seguro de cuáles necesitas, habilita primero la Maps JavaScript API. Puedes agregar más después sin crear una nueva clave.

Paso 4: Configura la facturación

Este paso confunde a muchos desarrolladores. Google requiere una cuenta de facturación incluso si te mantienes dentro del nivel gratuito.

En la Consola GCP, ve a Facturación en la barra lateral izquierda
Haz clic en Vincular una cuenta de facturación
Crea una nueva cuenta de facturación si no tienes una
Ingresa los detalles de tu tarjeta de crédito

No se te cobrará a menos que tu uso supere el crédito gratuito de $200/mes. Para la mayoría de los pequeños proyectos, eso cubre aproximadamente:

28,000 cargas de mapas por mes
40,000 solicitudes de geocodificación por mes

Configura una alerta de presupuesto (Facturación → Presupuestos y Alertas) para que recibas un correo electrónico si te acercas a un umbral. Esto previene facturas sorpresas.

Paso 5: Crea tu clave API

Ahora la creación real de la clave:

Ve a APIs y Servicios → Credenciales
Haz clic en + Crear Credenciales en la parte superior
Selecciona Clave API
Google genera tu clave de inmediato — se ve como AIzaSyD...
Cópiala y guárdala en un lugar seguro (un gestor de contraseñas funciona bien)

Eso es todo. La clave está activa de inmediato.

Paso 6: Asegura tu clave API

Una clave API no asegurada es un riesgo. Si alguien la encuentra en tu repositorio público de GitHub o en el código del lado del cliente, puede acumular cargos en tu cuenta.

Dos restricciones que debes establecer de inmediato:

Restricciones de Aplicación

Limita qué aplicaciones o sitios web pueden usar la clave.

Referentes HTTP — para sitios web. Agrega tu dominio: https://tudominio.com/*
Direcciones IP — para aplicaciones del lado del servidor. Agrega la IP de tu servidor.
Aplicaciones Android/iOS — para aplicaciones móviles. Agrega el nombre del paquete de tu aplicación o el ID del paquete.

Restricciones de API

Limita qué APIs de Google puede llamar la clave.

En la configuración de la clave, haz clic en Restringir clave
Selecciona solo las APIs que habilitaste en el Paso 3
Haz clic en Guardar

De esta manera, incluso si la clave se filtra, solo puede llamar a las APIs de Maps, no a Gmail, Drive o cualquier otra cosa.

Mejores Prácticas para Gestionar tu Clave API

Unos pocos hábitos que evitan dolores de cabeza más adelante:

Nunca codifiques la clave en JavaScript del lado del cliente. Cualquiera puede ver el código fuente de tu página y extraerla. Usa variables de entorno en el lado del servidor y proxy para las solicitudes.

Usa claves separadas para entornos separados. Una clave para desarrollo, una para producción. De esa manera, puedes rotar o revocar una sin romper la otra.

Monitorea el uso semanalmente. Revisa APIs y Servicios → Tablero para ver el conteo de solicitudes por API. Los picos pueden indicar abuso o un error en tu código.

Rota las claves periódicamente. Crea una nueva clave, actualiza tu aplicación y luego elimina la antigua. La rotación trimestral es un ritmo razonable para la mayoría de los proyectos.

Establece límites de cuota. En la configuración de la clave, puedes limitar las solicitudes diarias por API. Esto actúa como un techo estricto sobre los costos.

Incrustando Google Maps en tu Sitio Web

Con tu clave lista, aquí está el HTML mínimo para mostrar un mapa:

<!DOCTYPE html>
<html>
<head>
  <title>Mi Mapa</title>
  <script src="https://maps.googleapis.com/maps/api/js?key=TU_CLAVE_API&callback=initMap" async defer></script>
  <script>
    function initMap() {
      var map = new google.maps.Map(document.getElementById('map'), {
        center: { lat: 40.7128, lng: -74.0060 },
        zoom: 12
      });
    }
  </script>
</head>
<body>
  <div id="map" style="height: 400px; width: 100%;"></div>
</body>
</html>

Reemplaza TU_CLAVE_API con tu clave real. Los atributos async defer cargan el script sin bloquear la representación de la página.

Para sitios de WordPress, plugins como WP Google Maps o el widget de mapa de Elementor manejan la incrustación — solo pega la clave en la configuración del plugin.

Resolviendo Problemas Comunes con la Clave API

"Esta página no puede cargar Google Maps correctamente"

Generalmente significa que falta la clave, está incorrecta o la API de Maps JavaScript no está habilitada. Verifica ambas.

El mapa se carga pero muestra un cuadro gris

La API se cargó pero initMap() no se ejecutó. Revisa la consola de tu navegador en busca de errores de JavaScript.

Error "REQUEST_DENIED"

Tu clave tiene restricciones que bloquean la solicitud. O el referente no coincide, o la API no está en la lista permitida. Elimina temporalmente las restricciones para probar, luego vuelve a agregarlas.

Error de facturación / API deshabilitada

Si tu cuenta de facturación tiene un problema (tarjeta expirada, pago fallido), Google deshabilita las APIs. Soluciona el problema de facturación en la Consola GCP bajo Facturación → Gestión de Cuentas.

Cuota excedida

Has alcanzado tu límite diario o mensual. Revisa APIs y Servicios → Cuotas. Puedes solicitar un aumento de cuota o actualizar tu plan de facturación.

Precios de la API de Google Maps (2025)

Google te da $200/mes en créditos gratuitos. Después de eso, pagas por solicitud:

API	Precio después del nivel gratuito
Maps JavaScript API	$7 por 1,000 cargas
Geocoding API	$5 por 1,000 solicitudes
Places API (básico)	$17 por 1,000 solicitudes
Directions API	$5 por 1,000 solicitudes

Para casos de uso de alto volumen — como el scraping de miles de listados de negocios — los costos de la API de Places se acumulan rápidamente. A $17 por 1,000 solicitudes, obtener 50,000 registros de negocios cuesta $850 solo en tarifas de API, antes de cualquier tiempo de desarrollo.

Ahí es donde las bases de datos preindexadas se convierten en una alternativa práctica.

Usando Datos de Google Maps para Generación de Leads — Sin Límites de API

La API de Google Maps está diseñada para incrustar mapas y geocodificar direcciones. No está diseñada para la extracción masiva de datos de negocios. La API de Places limita los resultados a 60 por búsqueda, y el scraping a gran escala viola los Términos de Servicio de Google.

Si tu objetivo es construir listas de leads a partir de Google Maps — no incrustar mapas en un sitio web — una base de datos preindexada es un camino más rápido y económico.

IBLead indexa más de 50 millones de negocios en 37 países, actualizados semanalmente. Buscas por ciudad, código postal, categoría, calificación de Google o conteo de reseñas. Luego exportas a CSV al instante — sin llamadas a la API, sin esperar, sin facturación por solicitud.

Los datos incluyen nombre del negocio, dirección, teléfono, email (enriquecido desde el sitio web), calificación de Google, conteo de reseñas y más de 50 campos por listado. IBLead también detecta más de 160 tecnologías en el sitio web de cada negocio — útil para dirigir negocios que utilizan plataformas CMS específicas o herramientas publicitarias.

Por $52 por 10,000 leads, es una fracción de lo que costaría la API de Places para el mismo volumen.

Comienza gratis — 200 créditos incluidos

FAQ: Clave API de Google Maps

¿Es gratuita la API de Google Maps?

Sí, hasta $200/mes en uso. Después de eso, pagas por solicitud. La mayoría de los pequeños sitios web se mantienen dentro del nivel gratuito. La extracción de datos de alto volumen es donde los costos aumentan rápidamente.

¿Puedo usar una clave API para múltiples sitios web?

Técnicamente sí, pero es una mala práctica. Usa claves separadas por proyecto para que puedas rastrear el uso y revocar el acceso de manera independiente.

¿Qué pasa si no aseguro mi clave API?

Cualquiera que la encuentre puede usarla. Tu cuenta de facturación se cargará por su uso. Google tiene detección automatizada para algunos patrones de abuso, pero no es infalible. Siempre restringe tu clave.

¿Cuánto tiempo tarda en obtener una clave API de Google Maps?

Alrededor de 10 minutos si ya tienes una cuenta de Google. El principal tiempo de espera es configurar la facturación — ten lista tu tarjeta de crédito.

¿Hay una alternativa a la API de Google Maps para datos de negocios masivos?

Sí. Si necesitas listados de negocios a gran escala en lugar de incrustaciones de mapas, bases de datos preindexadas como IBLead son más prácticas. No tienen precios por solicitud ni el límite de 60 resultados por búsqueda de la API de Places.

Resumen

Configurar tu clave API de Google Maps toma seis pasos: crear una cuenta de GCP, iniciar un proyecto, habilitar las APIs que necesitas, agregar facturación, generar la clave y restringirla. Todo el proceso toma menos de 15 minutos.

La clave desbloquea incrustaciones de mapas, geocodificación y enrutamiento para tus aplicaciones. Para la mayoría de los sitios web, te mantendrás dentro del nivel gratuito de $200/mes sin cargos.

Si estás usando Google Maps para generación de leads en lugar de incrustaciones de mapas, el precio por solicitud de la API y los límites de resultados hacen que la extracción masiva sea costosa y lenta. Una base de datos preindexada te proporciona los mismos datos — más rápido, más barato y sin riesgo de Términos de Servicio.