- Google Timeline Visualizer convierte archivos JSON de Timeline exportados en videos de viaje MP4 animados.
- Los usuarios de Android instalan el APK desde la versión más reciente del repositorio en GitHub.
- Los usuarios de iPhone abren la aplicación web en Safari sin instalar una aplicación nativa.
- Enfoque de privacidad: el JSON de Timeline permanece local, mientras que los mosaicos del mapa se solicitan a CARTO.
- Mejor flujo de trabajo: restaura el historial que falta, exporta un intervalo de fechas pequeño, previsualízalo y luego renderízalo.
Descripción general del repositorio de GitHub de Google Timeline Visualizer
El repositorio de GitHub de Google Timeline Visualizer ofrece una forma de código abierto de convertir los datos de Timeline del historial de ubicaciones de Google en un video de viaje animado. En lugar de depender de un panel en la nube, la herramienta lee un archivo local Timeline.json, permite seleccionar un intervalo de meses o fechas exactas, previsualiza el recorrido y crea un MP4 para verlo o compartirlo.
El proyecto admite flujos de trabajo en Android y iPhone, además de un generador independiente en Python para usuarios de escritorio. La aplicación de Android se distribuye mediante versiones de GitHub en lugar de Google Play, mientras que los usuarios de iPhone pueden abrir la aplicación web en Safari y añadirla a la pantalla de inicio.
Aspectos destacados del video:
- Exportar el JSON de Timeline desde Android o iPhone
- Ejecutar el visualizador localmente en lugar de subir el archivo de historial
- Previsualizar una ruta antes de crear un MP4
- Seleccionar el movimiento de la cámara y rangos de fechas exactos
- Guardar los videos terminados en una biblioteca local
| Plataforma | Método de acceso | Flujo de trabajo del archivo de Timeline | Salida |
|---|---|---|---|
| Android | Versión APK de GitHub | Exportar desde Ajustes del teléfono | MP4 guardado localmente |
| iPhone | Aplicación web de Safari | Exportar desde Google Maps | MP4 disponible para reproducir, compartir o descargar |
| Escritorio | Versión de línea de comandos en Python | Proporcionar Timeline.json como entrada | Video de viaje renderizado |
APK de Android
- Descarga el
TimelineVisualizer-*.apkmás reciente - Requiere Android 8.0 o posterior
- Desactiva el permiso de instalación después de la configuración
Aplicación web para iPhone
- Usa Safari 16.4 o posterior
- No se requiere instalación nativa
- El JSON de Timeline permanece en el dispositivo
Python para escritorio
- Requiere Python 3.9+
- Utiliza FFmpeg y las dependencias del proyecto
- Es útil para renderizados mediante scripts o por lotes
Usa el repositorio oficial de Google Timeline Visualizer en GitHub, mahlernim/google-timeline-visualizer, como fuente para las versiones, la documentación, los detalles de privacidad y las instrucciones de compilación. Evita descargar archivos APK desde sitios espejo de terceros.
Exporta tu JSON de Google Timeline
El visualizador necesita un archivo de Timeline exportado. Los menús de exportación difieren considerablemente entre Android y iPhone, así que sigue con cuidado la ruta específica de tu plataforma. Si el archivo no contiene historial, restaura primero Timeline en Google Maps y después exporta una nueva copia.
| Dispositivo | Ruta del menú | Nombre o ubicación del archivo | Nota importante |
|---|---|---|---|
| Android | Ajustes del teléfono → Ubicación → Servicios de ubicación → Timeline | Guarda Timeline.json en Descargas u otra carpeta persistente | La exportación se gestiona desde los ajustes del sistema |
| iPhone | Google Maps → Foto de perfil → Ajustes → Contenido personal → Exportar datos de Timeline | Guarda el archivo en la aplicación Archivos | El JSON también se puede transferir a un dispositivo Android |
| Historial faltante | Enlace de restauración de Google Maps | Restaura el historial antes de volver a exportar | El visualizador no puede acceder a las copias de seguridad cifradas de Google |
Comprueba los datos existentes de Timeline
Abre Google Maps o los ajustes correspondientes de Timeline y confirma que el dispositivo contiene el historial de viajes que esperas. Si cambiaste de teléfono, reinstalaste Maps o restableciste el dispositivo, es posible que primero debas restaurar los viajes antiguos.
Exporta desde Android
Abre los Ajustes del teléfono, selecciona Ubicación, elige Servicios de ubicación y abre Timeline. Selecciona Exportar datos de Timeline, continúa en la pantalla de confirmación y guarda el archivo JSON resultante en una carpeta local fácil de encontrar.
Exporta desde iPhone
Abre Google Maps, toca la foto de perfil, selecciona Ajustes, abre Contenido personal y elige Exportar datos de Timeline. Guarda el archivo exportado dentro de la aplicación Archivos de Apple.
Verifica el archivo
Confirma que se puede acceder al archivo y que contiene el periodo esperado. Una exportación sin datos normalmente indica que la base de datos local de Timeline no se ha restaurado o no contiene datos.
Si tu teléfono muestra etiquetas diferentes, utiliza las instrucciones del repositorio para Obtener el archivo de Timeline. Los nombres de los menús de Android pueden variar según el fabricante, y la aplicación no puede proporcionar un enlace directo universal a la página de ajustes de Timeline de todos los dispositivos.
Si tus viajes antiguos desaparecieron después de cambiar de dispositivo, utiliza primero el proceso de restauración de Google Maps. Google Timeline Visualizer no puede iniciar sesión en tu cuenta ni recuperar directamente datos de copias de seguridad cifradas.
Instala y protege el flujo de trabajo local
El proyecto está diseñado para realizar el procesamiento localmente. Tu JSON de Timeline no se sube a un servidor del proyecto, y la aplicación no requiere iniciar sesión con Google para leer el archivo exportado. La única función descrita por el proyecto que depende de la red es el acceso al mapa base.
Los mosaicos del mapa se solicitan a CARTO y utilizan datos de OpenStreetMap. Estas solicitudes pueden revelar al proveedor de mosaicos qué áreas del mapa estás viendo, pero no suben el propio JSON de Timeline. Revisa el aviso de privacidad antes de cargar un archivo, especialmente cuando trabajes con rutas que revelen tu domicilio, lugar de trabajo o patrones de desplazamiento diario.
| Área de privacidad | Cómo la gestiona el visualizador | Recomendación práctica |
|---|---|---|
| JSON de Timeline | Se procesa localmente y no se sube | Mantén el archivo en una carpeta protegida |
| Cuenta de Google | No requiere iniciar sesión con Google | Exporta o restaura los datos mediante Google Maps por separado |
| Mosaicos del mapa base | Se solicitan a CARTO durante el renderizado del mapa | Revisa el aviso de privacidad del mapa antes de continuar |
| MP4 renderizado | Se almacena en el dispositivo | Compártelo solo después de comprobar los detalles de la ruta |
| JSON original | Los filtros no lo modifican | Conserva una copia de seguridad intacta antes de realizar pruebas |
Seguridad de los archivos
Guarda el JSON localmente, limita los envíos innecesarios y conserva una copia de seguridad intacta antes de editar o mover archivos.
Gestión de permisos
Android puede requerir temporalmente el permiso para instalar aplicaciones desconocidas. Revócalo después de instalar el APK.
Revisión antes de compartir
Comprueba la ruta final antes de enviar un MP4. Una animación de viaje puede revelar ubicaciones y rutinas sensibles.
La aplicación puede aplicar de forma predeterminada un filtrado conservador de valores atípicos del GPS. Esto ignora coordenadas aisladas e inverosímiles de ida y vuelta, al tiempo que deja intacto el JSON original. Puedes desactivar el filtrado cuando necesites incluir todos los puntos de ubicación, pero previsualiza cuidadosamente el resultado antes de renderizarlo.
El procesamiento local protege el archivo de Timeline frente a las cargas al servidor del proyecto, pero no hace anónimo el MP4 terminado. Revisa los mosaicos del mapa, los detalles de la ruta y los permisos de uso compartido antes de publicar un video.
Crea un MP4 de viaje animado
Después de cargar el archivo de Timeline, el flujo principal es sencillo: elige el periodo, configura el estilo visual, previsualiza el recorrido y renderiza el video final. Comienza con un intervalo corto o un periodo de prueba pequeño antes de procesar varios años de historial de ubicaciones.
| Ajuste | Opciones disponibles | Mejor uso |
|---|---|---|
| Intervalo de fechas | Intervalo mensual o fechas exactas | Usa fechas exactas para un viaje o evento breve |
| Unidad de distancia | Unidad seleccionable | Adáptala a la unidad que utilice tu audiencia |
| Movimiento de cámara | Estable, Fijo o Dinámico | Elige según la complejidad de la ruta |
| Filtrado GPS | Conservador o Desactivado | Elimina valores atípicos aislados o conserva todos los puntos |
| Vista previa | Vista previa interactiva del recorrido | Confirma la geometría antes de renderizar |
| Salida | MP4 y resumen opcional del recorrido | Reproduce, guarda o comparte localmente |
Abre Crear video
Inicia la aplicación de Android o la aplicación web para iPhone y selecciona Crear video. Elige el archivo de Timeline exportado mediante el selector de archivos.
Establece el intervalo de fechas
Mantén el periodo amplio predeterminado para obtener una vista general del año, o selecciona Fechas exactas para aislar unas vacaciones, un viaje por carretera o un recorrido de varios días. Confirma que el intervalo seleccionado contiene datos de movimiento.
Elige el movimiento de la cámara
Usa Estable para una ruta más tranquila, Fijo cuando quieras una altitud bloqueada o Dinámico cuando la ruta se beneficie de una escala más agresiva. Los desplazamientos largos y dispersos se interpolan siguiendo una ruta de círculo máximo.
Previsualiza el recorrido
Selecciona Vista previa e inspecciona la geometría de la ruta, el movimiento del marcador y la cobertura del mapa. Si la trayectoria da saltos inesperados, comprueba los datos de origen y la opción de filtrado antes de renderizar.
Crea y guarda el MP4
Selecciona Crear video y supervisa las etapas del renderizado. En Android 10 y versiones posteriores, los archivos terminados se guardan en Movies/Timeline Visualizer; Android 8 y 9 utilizan el selector del sistema Guardar como.
La aplicación añade una breve secuencia final que se aleja para mostrar la ruta completa. En las versiones compatibles de Android, puedes cambiar de aplicación o apagar la pantalla mientras continúa el renderizado. Android 13 o posterior puede mostrar notificaciones de progreso cuando se permite el acceso a las notificaciones.
Previsualiza primero un intervalo de fechas corto. Esto confirma el acceso al archivo, la geometría de la ruta, el comportamiento de la cámara y la carga del mapa antes de que tu dispositivo dedique más tiempo a renderizar un Timeline grande.
Biblioteca de videos, solución de problemas y herramientas de escritorio
Los archivos MP4 terminados se añaden a Mis videos, donde cada entrada puede conservar una miniatura, el periodo de Timeline, la duración y la fecha de creación. Usa Añadir videos para incluir archivos MP4 anteriores. Eliminar un elemento de la lista no necesariamente borra el archivo subyacente, mientras que Eliminar video es una acción independiente que requiere confirmación.
| Problema | Causa probable | Solución recomendada |
|---|---|---|
| La exportación muestra cero datos | El Timeline local está vacío | Restaura el historial en Google Maps y vuelve a exportar |
| La instalación del APK está bloqueada | El permiso para aplicaciones desconocidas está desactivado | Permite temporalmente la instalación desde el navegador o el gestor de archivos |
| La ruta contiene saltos extraños | Valores atípicos del GPS o datos dispersos | Previsualiza con el filtrado Conservador activado |
| No se puede volver a abrir el archivo | El archivo se movió o se perdió el acceso del proveedor | Repite el flujo normal de carga del archivo |
| La entrada del video indica que no está disponible | El MP4 se movió o eliminó externamente | Elimina la entrada obsoleta de la biblioteca o restaura el archivo |
| El renderizado es demasiado grande para probarlo | El intervalo de fechas incluye demasiado historial | Usa Fechas exactas para realizar un renderizado de validación más pequeño |
Para la automatización en escritorio, el repositorio conserva el generador original en Python. La configuración documentada utiliza Python 3.9 o posterior, FFmpeg y los paquetes de requirements.txt.
python -m pip install -r requirements.txt python visualizer.py --input Timeline.json --year 2026 --camera-movement steady
El flujo de trabajo de línea de comandos es útil cuando quieres realizar renderizados repetibles o conversiones por lotes. Mantén local la ruta de entrada, verifica el año o periodo seleccionado y confirma que FFmpeg está disponible antes de comenzar un renderizado prolongado.
Antes de renderizar:
- Confirma que el JSON de Timeline contiene el periodo de viaje previsto
- Restaura el historial faltante de Google Maps antes de volver a exportar
- Previsualiza un intervalo de fechas corto e inspecciona la geometría de la ruta
- Revisa el aviso de privacidad y las áreas visibles del mapa
- Revoca el permiso de instalación de Android después de instalar el APK
Usa Mis videos para organizarte, pero recuerda que una entrada de la biblioteca y el archivo MP4 son elementos independientes. Comprueba la ubicación del archivo antes de eliminar o borrar una entrada.
Preguntas frecuentes sobre Google Timeline Visualizer
Q: ¿Google Timeline Visualizer sube mi JSON de Timeline?
La documentación del proyecto indica que el archivo de Timeline nunca se sube. El procesamiento se realiza localmente. Los mosaicos del mapa base se solicitan a CARTO, y esas solicitudes pueden revelar al proveedor de mosaicos las áreas del mapa que se están viendo.
Q: ¿Puedo usar el visualizador en un iPhone?
Sí. Abre la aplicación web para iPhone en Safari, selecciona el Timeline.json exportado desde Archivos, elige el intervalo de fechas y el movimiento de la cámara, previsualiza el recorrido y crea el MP4. No se requiere instalar una aplicación nativa.
Q: ¿De dónde deben descargar el APK los usuarios de Android?
Descarga el APK más reciente de TimelineVisualizer desde la sección Assets de la versión oficial de mahlernim/google-timeline-visualizer en GitHub. No selecciones el archivo de suma de comprobación y evita los sitios espejo de terceros.
Q: ¿Por qué desaparecieron mis viajes antiguos?
Cambiar de teléfono, reinstalar Google Maps o restablecer el dispositivo puede dejar vacía la base de datos local de Timeline. Restaura primero el historial cifrado en Google Maps y después exporta un archivo JSON de Timeline nuevo para el visualizador.
El repositorio también documenta la compatibilidad con las exportaciones actuales de Timeline en forma de matriz directa, las estructuras antiguas semanticSegments, rutas, actividades, visitas, varios formatos de coordenadas y rutas que cruzan la línea internacional de cambio de fecha. La alternativa de ubicación sin procesar puede mostrar una advertencia porque el procesamiento semántico no está disponible.
Para obtener instrucciones más amplias sobre la recuperación de la cuenta y de Timeline, consulta la Ayuda oficial de Google sobre Timeline. Usa el repositorio de GitHub para obtener los archivos de versión del visualizador, la explicación de privacidad, las instrucciones específicas de cada plataforma y la documentación de desarrollo.
El flujo de trabajo más seguro consiste en utilizar Google Maps para restaurar o exportar el historial y el visualizador de GitHub como herramienta local para previsualizar y renderizar ese archivo exportado.