API Google Maps y opiniones de Google: guía completa de explotación

Las opiniones de Google se han convertido en la decisión de compra n° 1 para los consumidores. El 92% de los usuarios leen las opiniones antes de elegir una empresa local. Pero, ¿cómo acceder a estos datos de manera sistemática? ¿Cómo analizarlos a gran escala?

Ahí es donde entra la API Google Maps. Ofrece un acceso estructurado a los datos de millones de lugares, incluidas las opiniones, las calificaciones, los horarios y mucho más.

Este artículo te muestra cómo utilizar la API Google Maps, sus límites reales, cómo asegurar tu clave API y, sobre todo, cómo aprovechar las opiniones para tu prospección comercial.

---

¿Qué es la API Google Maps?

La API Google Maps no es una herramienta única. Es un conjunto de APIs distintas, cada una con un rol específico.

Las principales APIs de Google Maps

Maps JavaScript API Integra mapas interactivos en tus páginas web. Puedes añadir marcadores, polígonos, rutas. Utilizada por el 99% de los sitios web con un mapa embebido.

Geocoding API Convierte una dirección en coordenadas GPS (latitud/longitud) o viceversa. Ejemplo: "10 rue de la Paix, París" → 48.8566, 2.3522.

Directions API Calcula las rutas entre dos puntos. Modos: coche, bicicleta, transporte público, a pie. Devuelve la duración, la distancia, los pasos detallados.

Places API Accede a la información sobre los lugares: restaurantes, hoteles, comercios, servicios. Es la API que te interesa si buscas extraer datos de negocio (nombre, dirección, teléfono, sitio web, opiniones).

Distance Matrix API Calcula las distancias y duraciones entre varios puntos. Útil para optimizar las rutas de entrega o de servicio.

Maps Static API Genera imágenes de mapas estáticos (PNG, GIF, JPG) sin interfaz interactiva.

Street View API Accede a las imágenes panorámicas de Street View.

Para la prospección comercial y el análisis de opiniones, utilizarás principalmente Places API.

---

Cómo obtener una clave API Google Maps

Paso 1: Crear una cuenta de Google Cloud

Ve a console.cloud.google.com.

Inicia sesión con tu cuenta de Google (o crea una).

Paso 2: Crear un proyecto

En la consola, haz clic en "Crear un proyecto" (en la parte superior izquierda).

Dale un nombre: "Prospección Comercial", "Análisis Opiniones", etc.

Espera unos segundos a que se cree el proyecto.

Paso 3: Activar las APIs necesarias

En el menú de la izquierda, ve a "APIs y servicios" → "Biblioteca".

Busca "Places API" y haz clic en "Activar".

Haz lo mismo para "Geocoding API" y "Maps JavaScript API" si las necesitas.

Paso 4: Crear una clave API

Ve a "APIs y servicios" → "Credenciales".

Haz clic en "Crear credenciales" → "Clave API".

Tu clave API aparecerá (una larga cadena de caracteres aleatorios).

Cópiala y mantenla en secreto.

Paso 5: Configurar la facturación

Google ofrece 200$ de créditos gratuitos por mes para las nuevas cuentas.

Ve a "Facturación" y vincula una tarjeta de crédito.

Importante: incluso con los créditos gratuitos, debes configurar la facturación para usar la API. Sin esto, la API se bloqueará después de agotar los créditos de prueba.

---

Precios de la API Google Maps: lo que necesitas saber

Google cobra por llamada API. Las tarifas varían según el servicio.

Costos reales (2024)

Places API (búsqueda y detalles)

• Búsqueda por texto: 32$ por 1,000 solicitudes
• Búsqueda cercana: 32$ por 1,000 solicitudes
• Detalles del lugar: 17$ por 1,000 solicitudes

Geocoding API

• 5$ por 1,000 solicitudes

Directions API

• 5$ por 1,000 solicitudes

Ejemplo concreto: extraer 10,000 restaurantes en Francia

Para buscar todos los restaurantes en Francia a través de Places API:

• 1 solicitud de búsqueda por área geográfica
• Si divides Francia en 50 áreas, te costará: 50 × 0.032$ = 1.60$
• Para recuperar los detalles de cada restaurante (teléfono, horarios, opiniones): 10,000 × 0.017$ = 170$
• Total: ~171.60$ por 10,000 restaurantes.

Es mucho si necesitas hacerlo regularmente.

Cuotas y límites

Google impone cuotas para proteger sus servidores:

• Solicitudes por segundo: 50 (gratis) o 100+ (con solicitud especial)
• Solicitudes por día: ilimitadas (pero facturadas)
• Resultados por solicitud: máximo 20 resultados (Places API)
• Resultados totales por búsqueda: máximo 60 resultados (3 páginas de 20)

Limitación crítica: con Places API, solo puedes recuperar 60 resultados por búsqueda. Para extraer 10,000 restaurantes, debes hacer 167 búsquedas diferentes (dividiendo geográficamente o por categoría).

Esto significa 167 solicitudes de búsqueda × 0.032$ = 5.34$ mínimo, más las solicitudes de detalle.

---

Asegurar tu clave API Google Maps

Tu clave API es como una contraseña. Si alguien la roba, puede hacer llamadas API a tu costa.

Riesgos reales

• Un atacante usa tu clave para hacer 100,000 solicitudes en una noche: 3,000$ de gastos
• Tu aplicación web expone la clave en JavaScript: cualquier usuario puede copiarla desde el código fuente
• Un empleado la publica accidentalmente en GitHub: los bots la detectan en segundos

Cómo proteger tu clave

1. Restringir por dominio (HTTP Referrer)

En la consola Google Cloud, ve a "Credenciales" → haz clic en tu clave API.

Bajo "Restricciones de aplicaciones", elige "Clave de sitio web HTTP (sitios web, dominios)".

Agrega tus dominios permitidos:

• www.tusitio.com
• tusitio.com
• app.tusitio.com

Solo se aceptarán las solicitudes provenientes de estos dominios.

2. Restringir por API

Bajo "Restricciones de API", marca solo las APIs que utilizas.

Si solo usas Places API, desactiva Geocoding, Directions, Street View, etc.

Así, incluso si alguien roba tu clave, no podrá usarla para acceder a otros servicios.

3. Monitorear el uso

Ve a "Facturación" → "Informes de uso".

Verifica cada día cuántas llamadas API haces.

Configura una alerta: si superas X$ por día, recibirás un correo electrónico.

4. Rotación regular

Crea una nueva clave API cada 3 meses.

Elimina la clave antigua.

Esto limita la duración durante la cual una clave robada puede ser utilizada.

5. Nunca exponer la clave en frontend

❌ Malo:

// En tu código JavaScript visible
const apiKey = "AIzaSyD..."; // EXPUESTA
fetch(`https://maps.googleapis.com/maps/api/place/textsearch/json?key=${apiKey}&query=restaurants`)

✅ Bueno:

// Desde tu frontend
fetch('/api/search-restaurants?query=restaurants')
// Tu backend hace la llamada API con la clave

Tu backend (Node.js, Python, PHP) mantiene la clave en secreto. El frontend nunca la ve.

6. Para aplicaciones móviles

Usa un proxy backend. Tu app móvil llama a tu servidor, que llama a Google Maps.

La clave API nunca se almacena en la app (puede ser descompilada).

---

Places API: cómo extraer los datos de los lugares

Places API te da acceso a la información básica sobre un lugar.

Tipos de búsqueda

Búsqueda de texto (búsqueda por texto)

https://maps.googleapis.com/maps/api/place/textsearch/json?query=restaurants+paris&key=YOUR_API_KEY

Devuelve:

• Nombre del restaurante
• Dirección
• Calificación de Google
• Número de opiniones
• Coordenadas GPS
• Place ID

Búsqueda cercana (búsqueda a proximidad)

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=48.8566,2.3522&radius=5000&type=restaurant&key=YOUR_API_KEY

Busca todos los restaurantes en un radio de 5 km alrededor de una coordenada.

Detalles del lugar (detalles del lugar)

https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJ...&key=YOUR_API_KEY

Recupera la información completa: teléfono, sitio web, horarios, fotos, opiniones, etc.

Datos disponibles a través de Places API

• Nombre, dirección completa, código postal
• Teléfono
• Sitio web
• Categorías (tipo de negocio)
• Calificación de Google (0-5 estrellas)
• Número total de opiniones
• Horarios de apertura
• Fotos (número y URL)
• Coordenadas GPS
• Place ID (identificador único de Google)

Lo que Places API NO da

❌ Texto de las opiniones (contenido de los comentarios) ❌ Autor de las opiniones ❌ Fecha de las opiniones ❌ Detalles de la ficha (fotos detalladas, videos) ❌ Historial de modificaciones

Para acceder al texto de las opiniones, debes hacer scraping directamente de la página de Google Maps o usar una herramienta especializada.

---

Analizar las opiniones de Google: estrategia y ejecución

Las opiniones de Google son una mina de oro para entender a tus competidores e identificar oportunidades comerciales.

Paso 1: Definir tus criterios de análisis

Antes de analizar, decide qué estás buscando.

Caso de uso 1: Identificar a los competidores mal valorados

Eres una agencia de reputación en línea. Buscas empresas con una calificación < 3 estrellas para contactarlas.

Criterios:

• Calificación promedio < 3 estrellas
• Al menos 20 opiniones (para evitar casos aislados)
• Últimas opiniones con menos de 3 meses (problema reciente)

Caso de uso 2: Analizar la satisfacción por sector

Eres consultor de marketing. Analizas la satisfacción promedio en tu región para cada sector (restaurantes, peluquerías, fontaneros, etc.).

Criterios:

• Calificación promedio por sector
• Número de opiniones por sector
• Evolución de la calificación en 12 meses

Caso de uso 3: Encontrar clientes para una agencia web

Vendes servicios web. Buscas empresas con un mal sitio web (obsoleto, no responsivo, sin formulario de contacto).

Criterios:

• Sin sitio web (o sitio muy antiguo)
• Calificación de Google < 4 estrellas (posible insatisfacción relacionada con la web)
• Número de opiniones > 50 (empresa establecida, puede permitirse invertir)

Paso 2: Extraer los datos

Utiliza Places API para recuperar la calificación y el número de opiniones.

Ejemplo en Python:

import requests

API_KEY = "YOUR_API_KEY"

def search_restaurants(city, min_rating=3.0):
    url = "https://maps.googleapis.com/maps/api/place/textsearch/json"
    params = {
        "query": f"restaurants {city}",
        "key": API_KEY
    }
    
    response = requests.get(url, params=params)
    results = response.json().get("results", [])
    
    filtered = [
        {
            "name": r["name"],
            "address": r["formatted_address"],
            "rating": r.get("rating", 0),
            "review_count": r.get("user_ratings_total", 0),
            "place_id": r["place_id"]
        }
        for r in results
        if r.get("rating", 0) >= min_rating
    ]
    
    return filtered

# Uso
restaurants = search_restaurants("París", min_rating=4.0)
for r in restaurants:
    print(f"{r['name']} - {r['rating']} ⭐ ({r['review_count']} opiniones)")

Paso 3: Analizar el contenido de las opiniones

Places API no da el texto de las opiniones. Debes hacer scraping directamente o usar una herramienta.

Análisis manual (para pequeño volumen)

1. Ve a Google Maps
2. Abre la ficha del competidor
3. Lee las opiniones (de la más reciente a la más antigua)
4. Anota los temas recurrentes: servicio, precio, limpieza, tiempo, etc.

Análisis automatizado (para gran volumen) Usa una herramienta de scraping o una API de terceros que extraiga el texto de las opiniones.

Busca los temas:

• Positivos: "servicio rápido", "acogida cálida", "excelente relación calidad-precio"
• Negativos: "espera demasiado larga", "personal grosero", "caro para la calidad"

Paso 4: Identificar las oportunidades

Ejemplo 1: Fontanero mal valorado

Encuentras un fontanero con 2.8 ⭐ (45 opiniones). Opiniones recientes mencionan: "presupuesto demasiado caro", "sin seguimiento", "tiempo de intervención largo".

Oportunidad: contactar al propietario para proponer una agencia de marketing para mejorar su reputación y su servicio al cliente.

Ejemplo 2: Restaurante sin sitio web

Encuentras un restaurante con 4.2 ⭐ (120 opiniones), pero sin sitio web. Opiniones mencionan: "difícil encontrar los horarios", "sin reservas en línea".

Oportunidad: ofrecer un sitio web con reservas en línea.

Ejemplo 3: Peluquería en declive

Encuentras una peluquería con una calificación que baja (4.5 → 3.8 en 6 meses). Opiniones recientes: "el propietario ha cambiado", "menos bueno que antes", "precios aumentados".

Oportunidad: contactar al nuevo propietario para proponer una formación al cliente o una auditoría de servicio.

---

Límites reales de la API Google Maps para la extracción de datos

Límite 1: Solo puedes recuperar 60 resultados por búsqueda

Places API devuelve un máximo de 20 resultados por página, 3 páginas = 60 resultados.

Para extraer 10,000 restaurantes en Francia, debes hacer 167 búsquedas diferentes (por área geográfica o por subcategoría).

Impacto: tiempo de procesamiento largo, costos elevados, riesgo de alcanzar las cuotas.

Límite 2: Las opiniones no son accesibles

Places API da el número de opiniones y la calificación promedio, pero no el texto de las opiniones.

Para analizar el contenido (lo que realmente dicen los clientes), debes hacer scraping directamente de Google Maps.

Impacto: debes usar dos herramientas (API + scraper) para tener una visión completa.

Límite 3: Las cuotas y costos se acumulan rápidamente

Cada solicitud cuesta. Para extraer 10,000 restaurantes con detalles, cuenta con 170$+.

Si necesitas actualizar los datos cada mes, son 2,000$ al año como mínimo.

Impacto: solución costosa para las pymes y agencias.

Límite 4: Los datos no se actualizan en tiempo real

La API indexa los datos, pero hay un retraso. Un nuevo restaurante puede tardar días en aparecer.

Impacto: datos ligeramente obsoletos.

Límite 5: Restricciones geográficas y legales

Google limita las solicitudes por región para evitar abusos. Algunos países tienen restricciones adicionales.

Impacto: imposible extraer masivamente ciertos sectores.

---

Usar IBLead: una alternativa para la prospección en Google Maps

Si buscas extraer datos de Google Maps y opiniones a gran escala, la API Google Maps tiene sus límites (costos, cuotas, datos incompletos).

IBLead ofrece un enfoque diferente: una base de datos preindexada de más de 5M de fichas de Google Maps, actualizada mensualmente, con acceso completo a las opiniones de Google.

¿Por qué IBLead en lugar de la API Google Maps?

1. Opiniones de Google incluidas (EXCLUSIVO)

IBLead hace scraping del texto completo de las opiniones.