- Google Timeline Visualizer Python convierte archivos JSON de Timeline exportados en vídeos de viajes renderizados localmente.
- La configuración de escritorio requiere Python 3.9 o posterior, FFmpeg y las dependencias del proyecto.
- La compatibilidad de formatos incluye exportaciones actuales, segmentos semánticos antiguos, actividades, visitas y varios estilos de coordenadas.
- El suavizado de rutas utiliza un filtrado conservador de valores atípicos y una interpolación de círculo máximo para viajes con pocos puntos.
- Nota de privacidad: el JSON de Timeline permanece local, mientras que las solicitudes de teselas del mapa pueden revelar las regiones visualizadas al proveedor de teselas.
google timeline visualizer python: Qué hace
La versión de escritorio en Python es una herramienta de renderizado local para las exportaciones de Google Maps Timeline. Lee un archivo Timeline.json guardado, interpreta los puntos de ubicación y la información de las rutas, y después produce un vídeo de mapa animado. Esto resulta útil para revisar viajes pasados sin subir el documento de Timeline a una aplicación de terceros.
La herramienta se entiende mejor como un renderizador retrospectivo, no como un servicio de seguimiento en tiempo real. No recopila movimientos nuevos de forma continua, no se conecta a una cuenta de Google ni restaura copias de seguridad cifradas de Timeline. Primero prepara y restaura tu historial en Google Maps, exporta el archivo y después utiliza el visualizador para crear un vídeo.
Aspectos destacados del vídeo:
- Análisis local de formatos fragmentados de exportación de Google Timeline
- Filtrado conservador de valores atípicos de GPS aislados
- Interpolación de círculo máximo para vuelos largos y rutas con pocos puntos
- Movimiento estable de cámara diseñado para reducir las sacudidas del mapa
- Renderizado local de vídeo mediante un flujo de trabajo de escritorio con Python
Renderizado local
Los datos de Timeline se procesan en el dispositivo en lugar de subirse como un archivo completo del historial.
Animación de rutas
El renderizador crea movimientos cinematográficos entre las fechas seleccionadas, incluidos los viajes de larga distancia.
Traducción de esquemas
El analizador gestiona varias estructuras de exportación, representaciones de coordenadas y formatos antiguos de Timeline.
Utiliza la versión de Python cuando quieras control desde el escritorio, comandos repetibles y acceso directo a los archivos MP4 generados.
| Capacidad | Versión de escritorio en Python | Resultado práctico |
|---|---|---|
| Entrada | Timeline.json exportado | Utiliza una copia local de tu historial de Timeline |
| Salida | Vídeo animado mediante FFmpeg | Crea un MP4 que puedes compartir |
| Procesamiento | Flujo de trabajo de línea de comandos en Python | Adecuado para tareas de escritorio repetibles |
| Seguimiento | Solo retrospectivo | No añade datos de ubicación en curso |
| Acceso a la cuenta | No compatible | No se necesita iniciar sesión en Google |
Configuración de Python y preparación del archivo
Antes de iniciar el renderizador, instala las herramientas de escritorio necesarias y coloca la exportación de Timeline en un directorio fácil de encontrar. El flujo de trabajo de escritorio documentado requiere Python 3.9 o posterior, FFmpeg y los paquetes incluidos en requirements.txt.
El archivo de entrada debe exportarse desde Google Maps o restaurarse allí antes de la exportación. El visualizador no puede abrir directamente la copia de seguridad móvil cifrada de Google ni acceder a tu cuenta para recuperar un historial que falte.
Conserva una copia de seguridad intacta de Timeline.json. El filtrado solo afecta al proceso de renderizado; el JSON original no se modifica, pero una copia separada protege frente a operaciones accidentales con los archivos.
Exporta los datos de Timeline
Exporta los datos de Timeline desde el dispositivo o mediante el flujo de Google Maps disponible en tu cuenta. En Android, la ruta documentada comienza en Ajustes del teléfono, dentro de Ubicación, Servicios de ubicación y Timeline. En iPhone, exporta los datos desde los ajustes de contenido personal de Google Maps y guarda el JSON en Archivos.
Instala las dependencias de Python
Confirma que tienes Python 3.9 o posterior y ejecuta python -m pip install -r requirements.txt desde el directorio del proyecto. Esto instala los paquetes necesarios para el generador de escritorio.
Instala FFmpeg
Añade FFmpeg al entorno de escritorio y confirma que el comando está disponible desde el terminal. FFmpeg gestiona la fase de compilación del vídeo y admite procesamiento multihilo.
Coloca el archivo JSON
Copia o mueve Timeline.json a una carpeta conocida. Utiliza la ruta completa si el terminal está funcionando desde un directorio diferente.
Ejecuta un renderizado enfocado
Comienza con un año o intervalo de fechas limitado y una opción de cámara estable. Revisa el resultado antes de intentar una exportación grande de varios años.
| Elemento de configuración | Requisito | Comprobación |
|---|---|---|
| Python | 3.9 o posterior | Ejecuta python --version |
| Motor de vídeo | FFmpeg | Confirma que se ejecuta desde el terminal |
| Paquetes | requirements.txt | Instálalos con pip |
| Entrada | Timeline.json | Conserva la copia de seguridad original |
| Primer renderizado | Intervalo limitado | Haz una prueba antes de una exportación larga |
Un patrón de comando documentado es:
python visualizer.py --input Timeline.json --year 2025 --camera-movement steady
El ejemplo utiliza un filtro del año 2025 según las instrucciones del proyecto. Para un flujo de trabajo actual en 2026, elige el año o intervalo de fechas que coincida con los datos exportados que quieras visualizar. Si tu versión del proyecto ofrece argumentos de fecha adicionales, utiliza la ayuda local del proyecto para confirmar la sintaxis exacta.
Un viaje corto es la opción más segura para el primer renderizado. Confirma que Python, FFmpeg, la ruta de entrada, el acceso al mapa y los permisos de salida funcionan antes de que una tarea más larga consuma tiempo adicional.
Formatos de Timeline compatibles y controles de ruta
Las exportaciones de Google Timeline pueden variar según el dispositivo, el historial de la cuenta y la generación de la exportación. El visualizador está diseñado para normalizar varias estructuras en lugar de asumir que todos los archivos utilizan un único esquema de coordenadas.
Las entradas compatibles incluyen exportaciones actuales con matrices directas, archivos antiguos que utilizan semanticSegments, rutas, actividades, visitas y datos de ubicación sin procesar opcionales. Los valores de coordenadas pueden aparecer como cadenas, valores latLng, campos de grados, cadenas geo: o coordenadas enteras E7.
| Entrada de Timeline | Tratamiento | Acción recomendada |
|---|---|---|
| Exportación actual con matriz directa | Se analiza como la estructura moderna de Timeline | Utiliza directamente el JSON exportado |
Exportación semanticSegments | Se traduce desde el formato anidado antiguo | Prueba primero un intervalo de fechas corto |
| Rutas, actividades y visitas | Se utilizan para crear el contexto de la ruta | Mantén seleccionados los periodos de viaje relevantes |
| Alternativa de ubicación sin procesar | Se analiza con una advertencia y reducción local del ruido | Inspecciona el número de puntos filtrados |
| Coordenadas E7 | Se convierten en latitud y longitud utilizables | Conserva el archivo de origen sin cambios |
La configuración de GPS predeterminada es el filtrado conservador de valores atípicos de GPS. Ignora puntos aislados e inverosímiles de ida y vuelta que podrían crear picos pronunciados o desvíos falsos. El método pretende mejorar la legibilidad sin reescribir los datos de origen.
Puedes desactivar el filtrado cuando cada punto registrado sea importante. Esto puede resultar útil para una inspección técnica, pero también puede hacer que la animación sea menos estable cuando Timeline contiene rebotes de GPS provocados por edificios, señales débiles o errores temporales de posicionamiento.
El filtro de valores atípicos es una preferencia de renderizado. Cambia los puntos que aparecen en la visualización generada, mientras que el archivo Timeline original sigue disponible para procesarlo más adelante.
Para vuelos largos y otras rutas con pocos puntos, el renderizador utiliza interpolación de círculo máximo. En lugar de dibujar una línea recta visualmente poco natural sobre un mapa plano, la ruta sigue el camino más corto sobre una esfera. Esto resulta especialmente útil para viajes que cruzan la línea internacional de cambio de fecha.
La cámara también utiliza un modelo de movimiento estable. Un marcador puede desplazarse dentro de una zona de visualización central mientras el mapa permanece estable. Cuando el marcador llega al límite, la cámara empieza a seguirlo. Esto reduce los desplazamientos rápidos de un lado a otro durante los trayectos locales.
| Control | Propósito | Mejor opción inicial |
|---|---|---|
| Intervalo de fechas | Limita el viaje mostrado | Fechas exactas para un solo viaje |
| Filtro por año | Selecciona un año natural | Utiliza un año para la prueba inicial |
| Movimiento de cámara | Controla cómo sigue el mapa | Estable para vídeos de viaje tranquilos |
| Filtrado de GPS | Elimina puntos aislados e inverosímiles | Conservador de forma predeterminada |
| Unidad de distancia | Cambia las medidas de viaje mostradas | Adáptala a tu audiencia o región |
Un intervalo de fechas reducido suele producir una historia más clara que renderizar un año completo. Utiliza una vista anual cuando el objetivo sea ofrecer una visión general de los viajes y no mostrar un único trayecto.
Renderizado, revisión y gestión de vídeos
Después de cargar el archivo, selecciona el periodo del viaje, el movimiento de la cámara y la unidad de distancia antes de previsualizarlo. La vista previa es interactiva y ayuda a identificar puntos ausentes, picos de GPS no deseados o una ruta demasiado amplia para el vídeo previsto.
El vídeo guardado utiliza el diseño seleccionado y prepara las teselas del mapa antes del renderizado. En Android, la aplicación relacionada almacena los archivos MP4 completados en una carpeta de películas específica, mientras que el flujo de trabajo de escritorio original escribe el resultado según el comportamiento de salida del proyecto y los permisos locales.
En el flujo de trabajo de Python, mantén abierto el terminal durante el primer renderizado para que los errores sean visibles. Una prueba breve puede revelar una dependencia ausente, un comando de FFmpeg no disponible, una ruta incorrecta o un archivo de entrada que no coincide con la estructura de exportación esperada.
No empieces con una década de historial de ubicaciones a menos que una prueba breve ya funcione. Los archivos grandes pueden incluir muchos puntos y requerir considerablemente más procesamiento y almacenamiento temporal.
Antes de crear el vídeo final:
- Conserva una copia de seguridad intacta de Timeline.json
- Confirma que Python 3.9 o posterior y FFmpeg están disponibles
- Prueba un intervalo de fechas corto o un solo viaje
- Revisa el filtrado de GPS y el movimiento de la cámara
- Comprueba el MP4 exportado y la atribución del mapa
| Etapa de revisión | Qué inspeccionar | Por qué es importante |
|---|---|---|
| Carga del archivo | Fechas y ubicaciones detectadas | Confirma que la exportación puede analizarse |
| Vista previa | Forma de la ruta y estabilidad de la cámara | Revela picos o movimientos excesivos |
| Informe de filtrado | Número de puntos ignorados | Ayuda a explicar las diferencias de la ruta |
| Renderizado | Progreso y salida final | Confirma que FFmpeg terminó correctamente |
| Vídeo final | Reproducción, atribución y copia para compartir | Evita publicar una ruta no deseada |
El ecosistema de aplicaciones también admite una biblioteca de vídeos local para archivos MP4 completados, miniaturas, títulos, periodos, duración y fechas de creación. Si mueves o eliminas un vídeo fuera de la biblioteca, su entrada puede dejar de estar disponible. Quitar una entrada de una lista es distinto de eliminar permanentemente el archivo subyacente.
Para los registros de viajes privados, revisa el vídeo terminado antes de compartirlo. Una animación de rutas puede revelar viviendas, lugares de trabajo, desplazamientos habituales, visitas médicas u otras ubicaciones sensibles, incluso cuando el JSON original nunca sale de tu ordenador.
Crea vídeos separados para viajes concretos en lugar de publicar un historial completo de ubicaciones. Así conservas la historia visual y reduces la exposición innecesaria de movimientos sensibles.
Límites de privacidad y flujos de trabajo alternativos
El diseño local mantiene el JSON de Timeline en el dispositivo durante el procesamiento. Sin embargo, los fondos de mapa requieren solicitudes externas de teselas. La explicación de privacidad documentada identifica a CARTO como proveedor del mapa base, cuyos datos cartográficos se basan en OpenStreetMap. Las solicitudes de las áreas mostradas pueden revelar al proveedor las regiones que se están visualizando.
Antes de que se cargue la primera tesela del mapa, revisa el aviso de privacidad y decide si este intercambio resulta adecuado para tu caso de uso. El procesamiento local reduce la necesidad de subir todo el historial, pero no hace invisibles todas las interacciones de red.
| Elemento de datos | Local o externo | Consideración de privacidad |
|---|---|---|
| JSON de Timeline | Procesamiento local | El visualizador no lo sube |
| Análisis del GPS | Local | Las coordenadas se interpretan en el dispositivo |
| Solicitudes de teselas del mapa | Externas | Las regiones visualizadas pueden ser visibles para el proveedor de teselas |
| MP4 renderizado | Salida local | Compartirlo puede revelar visualmente la ruta |
| Copia de seguridad de la cuenta de Google | Servicio de Google independiente | Restáurala en Google Maps antes de exportar |
Los usuarios que busquen almacenamiento persistente deben distinguir entre un visualizador y una base de datos de ubicaciones autoalojada. El visualizador es efímero: lee los datos, renderiza un vídeo y está diseñado para un uso retrospectivo. Un sistema espacial autoalojado tiene un propósito diferente, ya que almacena continuamente el historial de ubicaciones y permite realizar análisis a más largo plazo.
Un enfoque híbrido práctico consiste en mantener un sistema privado para los registros continuos y utilizar el visualizador solo cuando sea necesario crear una exportación cinematográfica. Las utilidades de migración también pueden ayudar a combinar exportaciones superpuestas o convertir estructuras propietarias en formatos geográficos más portátiles, pero debes revisar cada herramienta antes de confiarle datos sensibles.
Para el desarrollo de software, el repositorio incluye instrucciones de pruebas y compilación para los proyectos de escritorio y Android. Las dependencias de desarrollo de Python pueden instalarse con python -m pip install -r requirements-dev.txt, seguido del comando de pruebas del proyecto. Los requisitos de compilación de Android son independientes del flujo de trabajo de Python.
El documento de Timeline puede permanecer local mientras las solicitudes del mapa base siguen saliendo del dispositivo. Considera el aviso de privacidad, el proveedor de teselas y el MP4 final como partes independientes de tu modelo de amenazas.
Para conocer los detalles de implementación, consulta el repositorio de Google Timeline Visualizer en GitHub. El repositorio documenta los flujos de trabajo compatibles, las notas de instalación, el comportamiento de privacidad, los comandos de compilación y la licencia MIT.
FAQ: Google Timeline Visualizer Python
Q: ¿Para qué se utiliza Google Timeline Visualizer Python?
Es un flujo de renderizado de escritorio que lee un archivo JSON exportado de Google Timeline y crea un vídeo de viajes animado mediante Python y FFmpeg. Está destinado a la visualización retrospectiva, no al seguimiento continuo.
Q: ¿Qué requiere la versión de Python?
La versión de escritorio documentada requiere Python 3.9 o posterior, FFmpeg y los paquetes incluidos en requirements.txt. Instala los paquetes con python -m pip install -r requirements.txt antes de ejecutar el generador.
Q: ¿Puede restaurar una copia de seguridad perdida de Google Maps Timeline?
No. Primero restaura la copia de seguridad cifrada en Google Maps y después exporta un nuevo archivo JSON de Timeline. El visualizador no puede acceder a tu cuenta de Google ni abrir directamente la copia de seguridad cifrada.
Q: ¿El visualizador sube mi archivo de Timeline?
El flujo de trabajo documentado procesa el archivo de Timeline localmente y no lo sube. Las teselas del mapa son una función de red independiente, por lo que el proveedor de teselas podría saber qué áreas del mapa se solicitan.
Comienza con una exportación breve, utiliza un filtrado conservador, previsualiza la ruta y mantén bajo tu control tanto el JSON original como el MP4 final.