Clave API Google Maps: Guía completa para comenzar en 2025

¿Quieres integrar Google Maps en tu sitio, tu app móvil, o acceder a los datos cartográficos de Google? Necesitas una clave API.

Es más simple de lo que parece. Este artículo te muestra cómo crearla en 5 pasos, asegurarla correctamente, e integrarla en tu proyecto — sin complicaciones.

¿Qué es una clave API Google Maps?

Una clave API es una cadena de caracteres única generada por Google. Funciona como un identificador: autentica tu aplicación y permite el acceso a los servicios de Google Maps.

Concretamente: tu app o tu sitio envía esta clave a Google. Google verifica que tienes derecho a usar la API, y luego te devuelve los datos (mapas, direcciones, geolocalización, etc.).

Por qué es necesaria una clave API

Google utiliza las claves API por tres razones:

1. Autenticación — Google sabe que eres tú quien hace la solicitud, no alguien más
2. Seguimiento de uso — Google mide cuántas veces llamas a la API (para la facturación)
3. Seguridad — Puedes restringir el uso a ciertos dominios o aplicaciones

Sin clave API, Google no sabría quién eres. Con ella, puedes usar Maps JavaScript, Directions, Geocoding, Distance Matrix, y más de 10 servicios adicionales.

Los diferentes tipos de claves API Google Maps

Google ofrece varios tipos de claves según tu necesidad:

Clave API para Web (JavaScript) Utilizada para mostrar mapas interactivos en un sitio. Es la más común. Ejemplo: tienes un sitio de restaurante, integras un mapa para mostrar tu ubicación.

Clave API para Android Dedicada a las apps de Android. La configuras con el SHA-1 de tu certificado de aplicación.

Clave API para iOS Dedicada a las apps de iOS. La configuras con el Bundle ID de tu app.

Clave API para Geolocalización Acceso a la API de Geolocalización para localizar a un usuario (dirección IP, puntos de acceso WiFi, etc.).

Clave API para Street View Integración de las imágenes de Street View en tu app o sitio.

Cada tipo tiene sus propias restricciones y configuraciones. Puedes crear varias claves para diferentes proyectos.

Paso 1: Crear una cuenta de Google Cloud Platform

Antes que nada, necesitas una cuenta de Google Cloud Platform (GCP). Es la consola central donde gestionas todas las API de Google.

Requisitos previos

• Una cuenta de Gmail (obligatoria)
• Un método de pago válido (incluso para la prueba gratuita)

Crear tu cuenta GCP

1. Ve a Google Cloud
2. Haz clic en « Prueba gratuita » (en la parte superior derecha)
3. Inicia sesión con tu cuenta de Gmail
4. Acepta los términos y proporciona tu información de pago

Google te da $300 en créditos gratuitos durante 90 días. No se te cobrará hasta que superes esta cantidad.

Lo que recibes con la prueba gratuita

• Acceso completo a Google Cloud Platform
• Uso gratuito de la mayoría de las API (con límites)
• Créditos para servicios de pago
• Soporte técnico básico

Una vez que tu cuenta esté creada, accedes al Tablero de GCP. Es tu punto de partida para todo.

Paso 2: Crear y configurar un proyecto GCP

Un proyecto GCP es un contenedor para tus API, tus credenciales y tus configuraciones. Cada proyecto está aislado de los demás — es útil si gestionas varias apps o sitios.

Crear un nuevo proyecto

1. Inicia sesión en console.cloud.google.com
2. En la parte superior izquierda, verás « Seleccionar un proyecto » (con un pequeño menú desplegable)
3. Haz clic en él
4. Se abrirá una ventana. Haz clic en « NUEVO PROYECTO »
5. Asigna un nombre a tu proyecto (ej: "Mi Sitio Maps" o "App Móvil v1")
6. Selecciona una organización (o déjalo vacío)
7. Haz clic en « Crear »

Google crea el proyecto. Toma unos segundos.

Seleccionar tu proyecto como activo

Una vez creado, vuelve al menú « Seleccionar un proyecto » y haz clic en tu nuevo proyecto para activarlo.

Ahora estás en tu proyecto. Verás el Tablero con estadísticas vacías (normal, aún no has activado nada).

¿Por qué crear un proyecto dedicado?

Si tienes varios sitios o apps, crea un proyecto por sitio. Esto te permite: - Gestionar las claves API por separado - Rastrear los costos por proyecto - Revocar una clave sin afectar a los otros proyectos - Compartir el acceso a un proyecto sin compartir todos tus proyectos

Paso 3: Activar las API de Google Maps

Ahora que tu proyecto existe, debes activar las API que vas a utilizar.

Acceder a la Biblioteca API

1. En el menú lateral izquierdo, haz clic en « API y servicios »
2. Luego haz clic en « Biblioteca »

Verás una lista de cientos de API de Google. Buscarás la que necesitas.

Buscar y activar una API

Si quieres mostrar un mapa interactivo en un sitio: 1. Busca « Maps JavaScript API » 2. Haz clic en el resultado 3. Haz clic en « Activar »

Google activa la API para tu proyecto. Toma unos segundos.

Si deseas convertir una dirección en coordenadas GPS: 1. Busca « Geocoding API » 2. Haz clic en « Activar »

Si quieres calcular rutas: 1. Busca « Directions API » 2. Haz clic en « Activar »

Puedes activar varias API en el mismo proyecto. Compartirán la misma clave API (o claves separadas, tú decides).

Verificar que la API está activada

Ve a « API y servicios » → « API activadas ». Verás la lista de todas las API que has activado para este proyecto.

Paso 4: Crear tu clave API Google Maps

Ahora que la API está activada, debes crear la clave API que autentificará tu aplicación.

Generar la clave

1. Ve a « API y servicios » → « Credenciales »
2. En la parte superior, haz clic en « + Crear credenciales »
3. Selecciona « Clave API »

Google genera una clave API automáticamente. Se ve así:

AIzaSyDxxxxxxxxxxxxxxxxxxxxxxxxxxx

Es una larga cadena de caracteres. Cópiala y guárdala en algún lugar (la necesitarás muy pronto).

Dar un nombre a tu clave

Por defecto, Google la llama "API key 1". No es muy útil. Renómbrala:

1. Haz clic en el ícono de lápiz al lado de tu clave
2. Dale un nombre descriptivo (ej: "Maps Web Site", "Mobile App Android")
3. Haz clic en « Guardar »

Esto te ayuda a mantenerte organizado si tienes varias claves.

Paso 5: Asegurar tu clave API

ATENCIÓN: una clave API no asegurada puede ser utilizada por cualquiera. Alguien podría robar tu clave y hacer miles de llamadas a la API — y tú serías facturado.

Por eso, DEBES restringir el uso de tu clave.

Configurar las restricciones por HTTP Referrer

Es el método más común para un sitio web.

1. Ve a « Credenciales »
2. Haz clic en tu clave API
3. En « Restricciones de clave », selecciona « Restricción HTTP Referrer »
4. Haz clic en « Añadir un elemento »
5. Ingresa tu dominio: https://misitio.com/*
6. Haz clic en « Guardar »

Ahora, tu clave API solo funcionará en misitio.com. Si alguien intenta usarla desde otro dominio, Google la rechazará.

Configurar las restricciones para una app móvil

Para Android o iOS, no puedes usar HTTP Referrer (una app no tiene un "dominio").

En su lugar, usas:

Para Android: - Huella SHA-1 (fingerprint de tu certificado) - Nombre del paquete

Para iOS: - Bundle ID

Pide a tu desarrollador esta información. Es específica para tu app.

Restringir las API

También tienes la opción de restringir QUÉ API puede usar tu clave.

Ejemplo: tu clave solo puede usar la API de Maps JavaScript, no la API de Directions.

1. En la configuración de tu clave, ve a « Restricciones API »
2. Selecciona « Restringir el uso »
3. Marca solo las API que usas
4. Haz clic en « Guardar »

Es una capa de seguridad adicional. Si alguien roba tu clave, solo podrá usar las API permitidas.

Errores de seguridad a evitar

NUNCA expongas tu clave API en público: - ❌ En un archivo público de GitHub - ❌ En una URL visible (ej: https://sitio.com?key=AIzaSy...) - ❌ En un correo electrónico o mensaje de Slack - ❌ En SHA-1 o cualquier otro "codificación" (no es realmente seguro)

En su lugar: - ✅ Almacénala en una variable de entorno - ✅ Ponla en un archivo .env (nunca subido a GitHub) - ✅ Usa las restricciones HTTP Referrer o SHA-1 - ✅ Revoca la clave si está comprometida

Integrar tu clave API en tu código

Ahora que tienes tu clave, ¿cómo usarla?

Para un sitio web (JavaScript)

Es el método más simple. Agregas una etiqueta <script> con tu clave:

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

Reemplaza AIzaSyDxxxxxxxxxxxxxxxxxxxxxxxxxxx con tu verdadera clave.

Luego, en tu JavaScript, defines la función initMap:

function initMap() {
  const map = new google.maps.Map(document.getElementById('map'), {
    zoom: 12,
    center: { lat: 48.8566, lng: 2.3522 } // París
  });
}

Esto muestra un mapa centrado en París.

Para una app Android

En tu archivo AndroidManifest.xml:

<meta-data
  android:name="com.google.android.geo.API_KEY"
  android:value="AIzaSyDxxxxxxxxxxxxxxxxxxxxxxxxxxx" />

Para una app iOS

En tu archivo AppDelegate.swift:

import GoogleMaps

GMSServices.provideAPIKey("AIzaSyDxxxxxxxxxxxxxxxxxxxxxxxxxxx")

Para una solicitud API directa (Python, Node.js, etc.)

Si haces llamadas HTTP directas a la API de Google Maps (por ejemplo, Geocoding):

import requests

url = "https://maps.googleapis.com/maps/api/geocode/json"
params = {
  "address": "1600 Amphitheatre Parkway, Mountain View, CA",
  "key": "AIzaSyDxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

response = requests.get(url, params=params)
data = response.json()
print(data)

Los límites y costos de la API Google Maps

Google cobra por el uso de sus API. Pero hay límites gratuitos.

Límites gratuitos (por mes)

API	Límite gratuito
Maps JavaScript API	28,000 llamadas/mes
Geocoding API	25,000 llamadas/mes
Directions API	25,000 llamadas/mes
Distance Matrix API	25,000 llamadas/mes
Places API	25,000 llamadas/mes

Una vez que superes, Google te cobrará por uso.

Tarificación (después de superar los límites gratuitos)

• Maps JavaScript API: $7 por 1,000 llamadas
• Geocoding API: $5 por 1,000 llamadas
• Directions API: $5 por 1,000 llamadas

Si tienes un sitio con 100,000 visitas al mes, y cada visitante carga un mapa, haces 100,000 llamadas. Eso cuesta aproximadamente 700€/mes.

Cómo reducir los costos

1. Cachea los resultados — si haces Geocoding (dirección → coordenadas), almacena el resultado. No es necesario volver a hacer la solicitud.
2. Limita las llamadas — carga el mapa solo si el usuario lo solicita
3. Usa los límites gratuitos — para un sitio pequeño, 28,000 llamadas/mes suelen ser suficientes

¿Qué hacer si necesitas muchos datos de Google Maps?

Si necesitas extraer listas de negocios (nombres, direcciones, teléfonos, correos electrónicos) desde Google Maps, la API de Google no es la solución adecuada.

¿Por qué? Porque la API está diseñada para mostrar mapas y hacer cálculos (rutas, distancias). No está optimizada para extraer listas de negocios a gran escala.

Ahí es donde una base de datos preindexada como IBLead se vuelve útil.

IBLead vs API Google Maps

Caso de uso: quieres encontrar todos los fontaneros de París

Con la API de Google: - Debes hacer cientos de llamadas a la API (caro) - Estás limitado a 120 resultados por búsqueda - No puedes filtrar por calificación, número de reseñas, o tecnologías - Toma horas

Con IBLead: - Base de datos preindexada (más de 5M de negocios) - Exportar a CSV en 2 clics - Filtros avanzados (calificación de Google, número de reseñas, tecnologías detectadas, SIRET en Francia) - Resultados instantáneos - A partir de €44/mes

Ejemplo concreto: una agencia de SEO quiere encontrar todos los restaurantes sin Google Analytics para prospectar.

¿Con la API de Google? Imposible — la API no detecta tecnologías.

¿Con IBLead? Filtras por "tecnologías detectadas = sin Google Analytics" y exportas la lista en 30 segundos.

IBLead no es una alternativa a la API de Google. Es complementaria. Usas la API para mostrar un mapa en tu sitio. Usas IBLead para extraer listas de negocios.

FAQ — Clave API Google Maps

¿Puedo compartir mi clave API con alguien más?

No. Cada clave API es personal. Si la compartes, la otra persona puede usarla para hacer llamadas a tu cuenta (y tú serás facturado). Si necesitas compartir el acceso a un proyecto GCP, utiliza los roles de acceso en la configuración del proyecto.

¿Qué hago si mi clave API está comprometida?

1. Ve a « Credenciales »
2. Haz clic en el ícono de papelera al lado de tu clave
3. Confirma la eliminación

Crea una nueva clave. Las llamadas a la clave antigua fallarán inmediatamente.

¿Cuántas claves API puedo crear?

Tantas como desees. No hay límite. Es útil si tienes varias apps o sitios y quieres gestionarlos por separado.

¿Puedo usar la misma clave API para un sitio web Y una app móvil?

Técnicamente sí. Pero no se recomienda. Crea una clave por plataforma. Esto te permite revocar una clave si está comprometida, sin afectar a las demás.

¿La API de Google Maps es gratuita?

Parcialmente. Tienes límites gratuitos (28,000 llamadas/mes para Maps JavaScript). Más allá, pagas por uso. Los créditos de prueba gratuita (300$) a menudo cubren los primeros meses.