Guía para obtener tu clave API Google Maps con facilidad

Obtener tu clave API Google Maps con facilidad es posible — siempre que sigas los pasos correctos en el orden adecuado. Esta guía cubre todo: la creación de la cuenta de Google Cloud Platform, la activación de la API, la generación de la clave y la seguridad del acceso. Ya seas un desarrollador principiante o experimentado, tendrás tu clave operativa en menos de 20 minutos.

---

¿Qué es una clave API Google Maps?

Una clave API es una cadena de caracteres única generada por Google. Identifica tu aplicación ante los servidores de Google y autoriza el acceso a los servicios de Maps.

En concreto, es una "contraseña de aplicación". Sin ella, Google rechaza las solicitudes. Con ella, puedes mostrar mapas, calcular rutas, geolocalizar direcciones y mucho más.

También sirve a Google para medir tu consumo y facturarte si superas los límites gratuitos. Por eso, asegurarla correctamente es tan importante como crearla.

---

¿Por qué usar la API Google Maps?

Google Maps es la referencia mundial para todo lo relacionado con la cartografía y los datos de localización. Su API es utilizada por millones de aplicaciones.

Los casos de uso son numerosos:

• Mostrar un mapa interactivo en un sitio web o una aplicación móvil
• Calcular rutas entre dos puntos (coche, bicicleta, a pie)
• Geocodificar direcciones (convertir una dirección en coordenadas GPS)
• Integrar Street View en una interfaz
• Acceder a los datos de negocios locales a través de Places API

Cada uso corresponde a una API diferente. Google Maps Platform agrupa una veintena de servicios distintos, todos accesibles mediante una clave API.

---

Paso 1: Crear una cuenta de Google Cloud Platform

Todo comienza en Google Cloud Platform (GCP). Es la consola central que gestiona todos los servicios de Google destinados a los desarrolladores.

Necesitas una cuenta de Gmail activa. Si no tienes una, crea una primero en gmail.com.

Luego, ve a cloud.google.com y haz clic en "Comenzar gratis". Google ofrece 300 € de créditos gratuitos durante 90 días para nuevas cuentas. Se requiere una tarjeta de crédito para el registro, pero no se te cobrará hasta que superes los límites gratuitos.

Completa el formulario de registro: país, tipo de cuenta (particular o empresa), información de pago. Una vez validado, accedes al panel de control de GCP.

---

Paso 2: Crear un proyecto GCP dedicado

En GCP, todo se organiza por proyectos. Un proyecto agrupa las API activadas, las claves generadas, los límites y la facturación asociada.

Se recomienda encarecidamente crear un proyecto dedicado para cada aplicación o uso. Esto facilita la gestión de costos y accesos.

Aquí te explicamos cómo hacerlo:

1. En la parte superior de la interfaz, haz clic en el selector de proyecto (icono en forma de carpeta junto al logo de Google Cloud)
2. En la ventana que se abre, haz clic en "Nuevo proyecto"
3. Asigna un nombre explícito a tu proyecto — por ejemplo, "Maps-MiSitio" o "Geocodificación-App"
4. Deja la organización por defecto si no tienes una
5. Haz clic en "Crear"

La creación toma unos segundos. Una notificación aparecerá en la parte superior derecha cuando esté listo. Luego selecciona este proyecto como proyecto activo a través del selector.

---

Paso 3: Activar la API Google Maps deseada

Google Maps Platform agrupa varias API distintas. Debes activar solo aquellas que necesites — cada API activada consume límites por separado.

Acceder a la biblioteca de API

En el menú lateral izquierdo, haz clic en "API y servicios" y luego en "Biblioteca". Aparecerá un motor de búsqueda con todas las API disponibles.

Las principales API de Google Maps

API	Uso principal
Maps JavaScript API	Mapas interactivos en la web
Maps SDK for Android	Mapas en aplicaciones Android
Maps SDK for iOS	Mapas en aplicaciones iOS
Geocoding API	Conversión dirección ↔ coordenadas GPS
Places API	Búsqueda y datos de negocios locales
Directions API	Cálculo de rutas
Geolocation API	Localización por red (sin GPS)
Street View Static API	Imágenes de Street View en aplicaciones
Distance Matrix API	Distancias y tiempos de viaje en masa

Para un sitio web clásico con un mapa, activa Maps JavaScript API. Para acceder a los datos de negocios locales, activa Places API.

Activar una API

1. Busca la API en la biblioteca
2. Haz clic en su nombre para acceder a su página de detalles
3. Haz clic en el botón "Activar"

La activación es inmediata. Repite la operación para cada API necesaria.

---

Paso 4: Generar la clave API Google Maps

Este es el paso central. Una vez que la API está activada, puedes crear la clave que permitirá a tu aplicación utilizarla.

Acceder a la sección de Credenciales

En el menú "API y servicios", haz clic en "Credenciales". Esta página lista todas las claves API y otros identificadores de tu proyecto.

Crear la clave

1. Haz clic en "+ Crear credenciales" en la parte superior de la página
2. Selecciona "Clave API" en el menú desplegable
3. Google generará automáticamente una clave — se verá así: AIzaSyD-9tSrke72PouQMnMX-a7eZSW0jkFMBWY
4. Copia esta clave inmediatamente y guárdala en un lugar seguro (gestor de contraseñas, variable de entorno, etc.)
5. Haz clic en "Cerrar"

Importante: nunca compartas esta clave públicamente. No la comites en un repositorio Git público. No la muestres en una URL accesible.

---

Paso 5: Integrar la clave en tu aplicación

La forma de usar la clave depende del lenguaje y del contexto de tu proyecto.

En JavaScript (sitio web)

Para cargar la API Maps JavaScript en una página HTML, añade este script en tu <head> o antes del cierre del <body>:

<script src="https://maps.googleapis.com/maps/api/js?key=TU_CLAVE_API&callback=initMap" async defer></script>

Reemplaza TU_CLAVE_API por tu clave real. La función initMap se llama una vez que la API está cargada — es ahí donde inicializas tu mapa.

En Python (solicitudes del servidor)

Para usar la API Geocoding o Places desde un script de Python:

import requests

api_key = "TU_CLAVE_API"
address = "10 Rue de la Paix, París"

url = f"https://maps.googleapis.com/maps/api/geocode/json?address={address}&key={api_key}"
response = requests.get(url)
data = response.json()

print(data['results'][0]['geometry']['location'])

Este código devuelve las coordenadas GPS de la dirección proporcionada.

Buena práctica: variables de entorno

No pongas nunca tu clave en el código de forma directa. Usa una variable de entorno:

import os
api_key = os.environ.get("GOOGLE_MAPS_API_KEY")

O un archivo .env con la biblioteca python-dotenv. Esto evita filtraciones accidentales al hacer un push en GitHub.

---

Paso 6: Restringir y asegurar tu clave API

Una clave no restringida puede ser utilizada por cualquiera si se descubre. Google puede entonces facturarte llamadas que no has realizado. Por lo tanto, la restricción es innegociable.

Acceder a los parámetros de restricción

En "API y servicios" > "Credenciales", haz clic en el icono de lápiz junto a tu clave. Accederás a la página de configuración detallada.

Tipos de restricciones disponibles

Restricciones de aplicación — limitan las fuentes autorizadas a usar la clave:

• Referentes HTTP: para claves utilizadas en sitios web. Listas los dominios autorizados, por ejemplo misitio.com/* o *.misitio.com/*. Cualquier solicitud proveniente de otro dominio será rechazada.
• Direcciones IP: para claves utilizadas en el servidor. Listas las IP autorizadas.
• Aplicaciones Android: restricción por huella SHA-1 del certificado y nombre del paquete.
• Aplicaciones iOS: restricción por Bundle ID.

Restricciones de API — limitan las API que esta clave puede llamar:

• Selecciona "Restringir la clave" y marca únicamente las API que realmente utilizas.
• Una clave dedicada a Maps JavaScript API no debería poder llamar a Places API si no la necesitas.

Buena práctica: una clave por uso

Crea claves separadas para cada contexto: una para el front-end web, una para el back-end del servidor, una para la app móvil. Si una clave se ve comprometida, la revocas sin afectar a las demás.

---

Entender la facturación de Google Maps Platform

Google Maps Platform no es gratuito más allá de un cierto volumen. Cada API tiene sus propias tarifas.

Google ofrece 200 $ de créditos gratuitos por mes a todas las cuentas. Para la mayoría de los pequeños proyectos, esto es suficiente para mantenerse dentro de los límites gratuitos.

Más allá, las tarifas varían según la API:

• Maps JavaScript API: ~7 $ por 1,000 cargas de mapa
• Geocoding API: ~5 $ por 1,000 solicitudes
• Places API (Nearby Search): ~32 $ por 1,000 solicitudes

Configura alertas de presupuesto en GCP (menú "Facturación") para ser notificado si tu consumo supera un umbral definido. También puedes establecer un límite de gastos para evitar sorpresas desagradables.

---

Alternativas a la API Google Maps para la prospección comercial

La API Google Maps es ideal para mostrar mapas y geocodificar direcciones en una aplicación. Pero si tu objetivo es extraer datos de negocios locales para la prospección comercial, el enfoque es diferente.

La API Places de Google da acceso a los datos de negocios locales — pero es costosa a gran escala, limitada a 20 resultados por solicitud, y no proporciona correos electrónicos ni tecnologías web de los sitios.

Para generar listas de prospectos desde Google Maps, IBLead es una alternativa directa. La base cubre 50M+ negocios en 37 países, con más de 50 campos de datos por ficha: nombre, dirección, teléfono, correo electrónico, calificación de Google, número de reseñas, tecnologías del sitio web y más.

Sin scraping en tiempo real, sin espera. Todo ya está indexado y actualizado cada semana. Filtras por ciudad, categoría, calificación, tecnologías — y exportas en CSV en 2 minutos. A 44€ por 10,000 contactos, es 0,004€ por lead.

---

FAQ — Clave API Google Maps

¿La clave API Google Maps es gratuita?

Sí, dentro de los límites del crédito mensual de 200 $ ofrecido por Google. Para la mayoría de los pequeños proyectos, este crédito cubre todo el consumo. Más allá, Google cobra según las llamadas realizadas.

¿Cuánto tiempo se necesita para obtener una clave API Google Maps?

Alrededor de 10 a 20 minutos si partes de cero (creación de la cuenta GCP incluida). Si ya tienes una cuenta GCP y un proyecto configurado, la generación de la clave toma menos de 2 minutos.

¿Se pueden usar varias claves API en un mismo proyecto?

Sí. De hecho, se recomienda crear una clave por uso (front-end, back-end, móvil) para facilitar la gestión de restricciones y la revocación en caso de problemas.

¿Qué hacer si mi clave API se ve comprometida?

Ve inmediatamente a "API y servicios" > "Credenciales", haz clic en tu clave y selecciona "Regenerar clave". La antigua clave se invalida instantáneamente. Actualiza tu clave en todas tus aplicaciones.

¿Cuál es la diferencia entre la API Google Maps y la API Places?

Maps JavaScript API se utiliza para mostrar mapas interactivos en un navegador. Places API se utiliza para buscar lugares, obtener sus detalles (dirección, horarios, reseñas, fotos) y hacer autocompletado de direcciones. Ambas pueden ser utilizadas juntas en un mismo proyecto.

---

¿Listo para generar prospectos desde Google Maps?

Si buscas extraer datos de negocios locales para tu prospección — sin codificar, sin gestionar API, sin esperar — IBLead te da acceso a más de 50M de fichas preindexadas en 37 países.

Prueba con 200 créditos.

créditos gratuitos — 200 créditos incluidos