Pricing

Rating

Developer

Actor stats

Categories

Share

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:

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

$npminstall

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
npminstall-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.