Afluencia de Lugares Chile — Horarios populares

Consulta la actividad relativa de lugares en Chile. Entrega el perfil semanal por hora, el nivel en vivo cuando está disponible y la duración habitual de la visita cuando la fuente la informa. Descarga los resultados en Excel, CSV o JSON desde Apify.

Uso desde el formulario de Apify

1. Pega uno o más enlaces de fichas de Google Maps en Enlaces de lugares de Google Maps. También puedes utilizar Place IDs o búsquedas por categoría y ubicación.
2. Activa Incluir afluencia en vivo si necesitas ese dato cuando esté disponible.
3. Inicia la ejecución y revisa Resultados. Cada fila corresponde a un lugar con un perfil semanal validado.
4. Exporta los resultados para comparar horarios del mismo lugar o preparar una visita al entorno de un local comercial.

Para evaluar un posible local comercial, combina su arriendo y superficie con los horarios de negocios cercanos. Es una ayuda para preparar visitas: no mide el tránsito frente al inmueble ni demuestra ventas o rentabilidad.

Qué significa la afluencia

Los valores de 0 a 100 son relativos al momento de mayor actividad del mismo lugar. No representan cantidades de personas y no deben utilizarse para comparar directamente dos locales distintos. Un valor ausente se entrega como null; el Actor nunca lo reemplaza por cero.

La fuente es la interfaz pública de Google Maps. Este proyecto es no oficial y no está afiliado, patrocinado ni aprobado por Google.

Entradas

Puedes combinar:

• placeUrls: enlaces normales o cortos de lugares.
• placeIds: identificadores de Google Places.
• searches: búsquedas por categoría, ubicación y, opcionalmente, coordenadas y radio.
• includeLive: solicita el dato en vivo; está activo por defecto.
• proxyConfiguration: permite Apify Proxy o proxies propios.

Ejemplo de búsqueda:

{
  "searches": [
    {
      "query": "supermercados",
      "location": "Providencia, Chile",
      "maxPlaces": 5
    }
  ],
  "includeLive": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Cada búsqueda devuelve una selección no exhaustiva de hasta 50 lugares. La ejecución admite como máximo 100 solicitudes de navegador, tres pestañas simultáneas, dos intentos por lugar y una sola rotación de proxy. Los enlaces entregados directamente tienen prioridad cuando aparece el mismo Place ID en una búsqueda.

Resultado

El dataset predeterminado contiene únicamente lugares con una estructura semanal validada de siete días. Cada día incluye 24 horas: available: false y relativePopularity: null indican que la fuente no entregó esa hora; un cero solo aparece cuando la fuente informó cero explícitamente. Un día completo puede quedar sin observaciones si Google lo indica; no se interpreta como actividad cero.

Campos principales:

• lugar, dirección, Place ID, coordenadas, zona horaria y enlace canónico;
• perfil de lunes a domingo, hora por hora;
• afluencia en vivo y texto original, cuando existe;
• duración habitual mínima y máxima, cuando se puede interpretar con seguridad;
• consulta, posición, extracción UTC y hora local.

Estados y comportamiento seguro

El Actor distingue ok, no_data, not_found, invalid_input, blocked, temporary_source_error y source_changed.

no_data solo se usa cuando el lugar queda identificado y la interfaz muestra explícitamente que no existe información de horarios populares. Un campo estructurado vacío, por sí solo, se trata como un posible cambio de fuente y hace fallar la ejecución. Si Google muestra CAPTCHA, exige login, bloquea ambos intentos o cambia un formato que no puede validarse, la ejecución falla sin guardar resultados parciales.

Los diagnósticos se guardan por separado en DIAGNOSTICS. Incluyen códigos, tiempos y conteos, pero no almacenan páginas, respuestas internas, cookies, tokens ni parámetros de seguimiento. No se crean filas diagnósticas en el dataset.

Precio configurado

El uso de plataforma está incluido. En los planes Free y Bronze, cada ejecución cuesta USD 0,005 por el inicio con 2 GB de memoria, más USD 0,003 por cada lugar válido guardado. En Silver son USD 0,0044 más USD 0,0027 por lugar; en Gold, Platinum y Diamond son USD 0,004 más USD 0,0024 por lugar.

El cobro por resultado utiliza el evento sintético del dataset de Apify: solo se cobra una fila después de que quedó guardada. no_data, not_found, bloqueos y diagnósticos no generan cobros por resultado. Si el usuario fija un límite de gasto que no admite todas las filas, el Actor entrega únicamente las que caben dentro de ese límite y marca la salida como partial.

Extracción

El navegador reutilizable utiliza Scrapling 0.4.15 con idioma es-CL y zona America/Santiago. Primero intenta validar las respuestas estructuradas internas y APP_INITIALIZATION_STATE. Si eso no entrega una semana válida, utiliza como respaldo la región accesible de horarios populares y la relocalización adaptativa de Scrapling. El respaldo solo se acepta si confirma la identidad del lugar, los siete días y una estructura horaria válida.

Se bloquean imágenes, videos y fuentes para reducir tiempo y memoria, pero se conservan JavaScript, estilos y solicitudes necesarias para Maps. No se intenta eludir CAPTCHA, login ni controles persistentes.

Límites de esta versión

• Google puede no publicar horarios populares, afluencia en vivo o duración para un lugar.
• La búsqueda por área no representa un censo completo.
• La actividad depende de una fuente externa y puede cambiar o dejar de estar disponible.
• Google puede entregar versiones distintas de la ficha según la conexión. El proxy es opcional; si esa ruta no permite validar los horarios, la ejecución falla sin convertir la ausencia incierta en cero.

Consulta las condiciones de Google Maps y las condiciones de publicación de Apify. La disponibilidad de información depende de Google Maps y no implica una autorización general para cualquier uso posterior.

Desarrollo local

python -m pip install -r requirements.txt
scrapling install
python -m unittest discover -s tests -p 'test_*.py' -v
python -m py_compile afluencia_scraper.py maps_client.py src/__main__.py

Para usar Google Chrome ya instalado localmente, define SCRAPLING_BROWSER_EXECUTABLE con la ruta del ejecutable. La imagen del Actor fija Python, Playwright, Patchright y la imagen base por digest.

Consulta ../THIRD_PARTY_NOTICES.md para las dependencias y referencias técnicas utilizadas.