Google Maps Scraper - Actor de Apify

Actor de Apify para extraer información de negocios en Google Maps de forma automatizada.

📋 Características

Extrae los siguientes datos de cada negocio:

• ✅ Nombre del negocio
• 📍 Dirección completa
• 📞 Número de teléfono
• 🌐 Sitio web
• 🗺️ Coordenadas GPS (latitud y longitud)
• 🔗 URL de Google Maps
• ⏰ Fecha de extracción

🚀 Cómo usar

Configuración de inputs

El actor requiere los siguientes parámetros:

Campo	Tipo	Requerido	Descripción	Ejemplo
searchQuery	String	✅ Sí	Palabra clave de búsqueda	"restaurantes"
city	String	✅ Sí	Ciudad donde buscar	"Madrid"
country	String	✅ Sí	País donde buscar	"España"
maxResults	Number	❌ No	Número máximo de resultados (predeterminado: 50)	100
language	String	❌ No	Código de idioma (predeterminado: "es")	"es"

Ejemplo de configuración JSON

{
  "searchQuery": "restaurantes italianos",
  "city": "Barcelona",
  "country": "España",
  "maxResults": 100,
  "language": "es"
}

📦 Instalación local

Prerrequisitos

• Node.js 16 o superior
• npm o yarn

Pasos de instalación

1. Clonar o descargar el proyecto

$cd google-maps-scraper

2. Instalar dependencias

$npm install

3. Ejecutar localmente

Crea un archivo input.json en la raíz del proyecto:

{
  "searchQuery": "cafeterías",
  "city": "Madrid",
  "country": "España",
  "maxResults": 50
}

Luego ejecuta:

$npm start

🐳 Despliegue en Apify

Opción 1: Desde Apify Console

1. Ve a Apify Console
2. Crea un nuevo Actor
3. Sube los archivos del proyecto
4. Configura los inputs según tus necesidades
5. ¡Ejecuta el actor!

Opción 2: Usando Apify CLI

# Instalar Apify CLI
npm install -g apify-cli

# Login en Apify
apify login

# Crear y desplegar el actor
apify push

📊 Formato de salida

Los datos se guardan en formato JSON con la siguiente estructura:

{
  "name": "Restaurante El Buen Sabor",
  "address": "Calle Mayor, 123, 28013 Madrid, España",
  "phone": "+34 912 345 678",
  "website": "https://www.ejemplo.com",
  "coordinates": {
    "latitude": 40.4168,
    "longitude": -3.7038
  },
  "url": "https://www.google.com/maps/place/...",
  "extractedAt": "2024-01-15T10:30:00.000Z"
}

⚙️ Configuración avanzada

Límites recomendados

• maxResults: Se recomienda entre 50-100 para mejor rendimiento
• Para más de 500 resultados, considera dividir en múltiples ejecuciones

Idiomas soportados

• es - Español
• en - Inglés
• pt - Portugués
• fr - Francés
• de - Alemán
• it - Italiano

🛠️ Tecnologías utilizadas

• Apify SDK 3.x - Framework para web scraping
• Playwright - Automatización de navegador
• Node.js - Runtime de JavaScript

📝 Notas importantes

1. Respeta los términos de servicio de Google Maps
2. Usa proxies si vas a hacer scraping masivo (configurable en Apify)
3. Rate limiting: El actor incluye delays para evitar bloqueos
4. Datos dinámicos: Algunos negocios pueden no tener toda la información disponible

🐛 Solución de problemas

El actor no encuentra resultados

• Verifica que la búsqueda sea válida en Google Maps manualmente
• Asegúrate de que el idioma coincida con el país
• Prueba con términos de búsqueda más específicos

Errores de timeout

• Reduce el maxResults
• Verifica tu conexión a internet
• Incrementa el requestHandlerTimeoutSecs en la configuración

Datos incompletos

• Algunos negocios no publican toda su información
• Los campos faltantes aparecerán como null en el JSON

📄 Licencia

ISC

👤 Autor

Creado para extracción de datos de Google Maps

🤝 Contribuciones

Las contribuciones son bienvenidas. Por favor, abre un issue o pull request.

---

Disclaimer: Este scraper es para fines educativos y de investigación. Asegúrate de cumplir con los términos de servicio de Google Maps y las leyes aplicables de protección de datos.