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 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 bash cd google-maps-scraper 2. Instalar dependencias bash npm install 3. Ejecutar localmente Crea un archivo input.json en la raíz del proyecto: json { "searchQuery": "cafeterías", "city": "Madrid", "country": "España", "maxResults": 50 } Luego ejecuta: bash 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 bash # 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: json { "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.