google timeline visualizer github: guía de configuración y consejos - GitHub

google timeline visualizer github: guía de configuración y consejos

Descubre cómo el proyecto Google Timeline Visualizer de GitHub convierte el historial de ubicaciones exportado en vídeos de viajes animados y privados.

2026-08-25
Equipo de google timeline visualizer
Guía rápida
  • Los proyectos de google timeline visualizer GitHub convierten el historial de ubicaciones exportado en vídeos de rutas animadas.
  • El procesamiento local mantiene el archivo de Timeline en tu dispositivo durante el análisis y la renderización.
  • La normalización de JSON ayuda a gestionar los formatos nuevos y antiguos del historial de ubicaciones de Google.
  • La revisión de privacidad es importante porque las solicitudes de teselas del mapa base pueden revelar las regiones consultadas.
  • Mejor flujo de trabajo: exporta, filtra, previsualiza, renderiza y luego almacena el MP4 terminado de forma segura.

Descripción general de google timeline visualizer github

Un visualizador de Google Timeline es una utilidad local diseñada para transformar el historial de ubicaciones de Google exportado en un viaje visual. En lugar de leer una cuenta de Google activa, el proyecto trabaja con un archivo proporcionado por el usuario, analiza los registros de ubicación y renderiza una ruta en movimiento sobre un mapa.

Su principal atractivo es el control. Una década de historial de ubicaciones puede ser difícil de interpretar cuando está almacenada como JSON fragmentado, especialmente después de que Google cambiara la forma de almacenar y exportar los datos de Timeline. Un visualizador ofrece una capa de traducción práctica entre las coordenadas sin procesar y una película de viajes fácil de ver.

Aspectos destacados del vídeo:

  • La renderización local puede convertir registros históricos de ubicación en animaciones de viajes cinematográficas.
  • La interpolación de círculo máximo suaviza los vuelos largos y las rutas que cruzan la línea internacional de cambio de fecha.
  • El filtrado conservador puede reducir los picos de GPS aislados sin editar el archivo de origen.
  • Las teselas del mapa siguen siendo la principal parte dependiente de la red dentro de un flujo de trabajo que, por lo demás, es local.
CapacidadQué hacePor qué importa
Análisis de TimelineLee el JSON exportado del historial de ubicacionesConvierte los registros sin procesar en datos de ruta utilizables
Animación de rutasMueve un marcador a lo largo del trayectoFacilita la comprensión del historial de viajes
Renderización localProcesa los datos en el dispositivoReduce la dependencia del análisis en la nube
Filtrado de ruidoIgnora puntos aislados e inverosímilesEvita saltos visuales causados por errores de GPS
Salida MP4Guarda un vídeo de viajes terminadoFacilita compartirlo y archivarlo
Consejo del editor

Considera el visualizador como un renderizador retrospectivo, no como un sustituto del seguimiento en directo. Crea una película a partir del historial existente en lugar de añadir continuamente nuevos desplazamientos.

Prepara tus datos de Timeline

La calidad de la animación final depende del archivo de Timeline exportado. Antes de abrir una versión de GitHub, una aplicación móvil, una aplicación web o un script de escritorio, crea una copia de trabajo limpia de la exportación. Mantén el archivo original sin cambios para poder repetir el proceso con distintos intervalos de fechas o configuraciones de filtrado.

Las exportaciones del historial de ubicaciones de Google pueden utilizar esquemas diferentes. Los archivos antiguos pueden contener matrices planas y coordenadas enteras E7 sin procesar, mientras que las exportaciones más recientes pueden utilizar segmentos semánticos, visitas, actividades o estructuras de ubicación anidadas. Un visualizador competente debe identificar los patrones compatibles y normalizarlos antes de dibujar la ruta.

Utiliza una estructura de carpetas clara, como la siguiente:

  • Timeline-original/ para la exportación intacta.
  • Timeline-working/ para las copias utilizadas durante las pruebas.
  • Timeline-videos/ para los archivos MP4 terminados.
  • Timeline-notes/ para los intervalos de fechas, la configuración y las decisiones de privacidad.
Elemento de datosVariación habitualConsideración de procesamiento
CoordenadasGrados decimales, latLng, geo: o valores E7Convierte todos los puntos a un formato geográfico uniforme
Valores de tiempoMarcas de tiempo ISO o campos de marcas de tiempo antiguosNormaliza el tiempo antes de ordenar el trayecto
Estructura de la rutaMatrices directas o segmentos semánticosDetecta el esquema antes de renderizar
ActividadesCaminar, conducir, montar en bicicleta o vuelosÚsalas como contexto, no como una verdad absoluta
VisitasLugares con nombre o inferidosRevisa la privacidad antes de incluirlas en vídeos compartidos

Planificación de la exportación

Selecciona un periodo que coincida con la historia que quieres contar. Un año completo puede ofrecer una visión general amplia, mientras que las fechas exactas son mejores para unas vacaciones, un viaje por carretera, una conferencia o una mudanza. Los intervalos más pequeños también son más fáciles de previsualizar y renderizar mientras pruebas el movimiento de la cámara.

Evita modificar las coordenadas manualmente. Si una ruta contiene un punto extraño, utiliza la opción de filtrado conservador del visualizador cuando esté disponible. Este enfoque conserva el JSON original y permite que la salida renderizada omita los desplazamientos aislados e inverosímiles de ida y vuelta.

Protege la exportación original

No sobrescribas el JSON de origen mientras pruebas filtros, intervalos de fechas o convertidores. Conserva una copia de seguridad intacta en un lugar privado antes de comenzar cualquier limpieza.

Flujo de renderización paso a paso

Un flujo de trabajo fiable separa la preparación de datos, la revisión de la ruta y la creación del vídeo. Esto facilita la identificación de errores y reduce la posibilidad de exportar un vídeo con un intervalo de fechas no deseado o una exposición de privacidad.

1

Exporta el archivo de Timeline

Utiliza el proceso de exportación de Google Timeline disponible para tu dispositivo y guarda localmente el archivo JSON resultante. Confirma que el archivo se puede leer y colócalo en una carpeta de trabajo privada.

2

Carga y selecciona las fechas

Abre el visualizador y elige el archivo de Timeline. Selecciona un intervalo mensual para una historia general o fechas exactas para un viaje concreto. Evita seleccionar más historial del que necesita el vídeo final.

3

Revisa la configuración del mapa y la cámara

Previsualiza la ruta antes de renderizarla. Comprueba si el marcador sigue las carreteras locales de forma natural, si los vuelos utilizan una trayectoria curva sobre el globo y si el movimiento de la cámara es lo bastante estable para visualizarlo.

4

Aplica el filtrado y crea el MP4

Mantén activado el filtrado conservador de valores atípicos de GPS cuando aparezcan picos aislados. Cuando la previsualización sea correcta, renderiza el MP4 y guárdalo en una carpeta de vídeos independiente.

El sistema de cámara está diseñado para evitar que el mapa tiemble constantemente. Durante los desplazamientos locales, el marcador puede moverse dentro de un área de visualización estable antes de que el mapa lo siga. Para rutas dispersas, como vuelos con pocos puntos registrados, la interpolación de círculo máximo crea un arco más natural a través del globo.

Etapa del flujo de trabajoOpción recomendadaPregunta de revisión
Intervalo de fechasFechas exactas para un viaje¿La selección contiene únicamente el trayecto previsto?
Filtro de GPSConservador de forma predeterminada¿Se eliminan los picos aislados sin modificar el JSON?
Cámara localMovimiento estable¿El mapa evita los movimientos rápidos de ida y vuelta?
Ruta de larga distanciaInterpolación de círculo máximo¿El arco del vuelo cruza el globo de forma natural?
SalidaMP4 más una vista general opcional¿El archivo terminado se almacena separado de los datos de origen?

Android

Un flujo de trabajo móvil nativo puede renderizar el trayecto directamente en un dispositivo Android compatible.

iPhone

Una aplicación web basada en Safari puede procesar el archivo seleccionado sin requerir una instalación tradicional.

Escritorio

Un flujo de trabajo con Python puede utilizar FFmpeg para compilar vídeos localmente y con múltiples hilos.

Híbrido

Utiliza un almacenamiento persistente para gestionar el historial y el visualizador para exportaciones cinematográficas seleccionadas.

Mejor práctica de renderización

Previsualiza primero y renderiza después. Una previsualización breve puede revelar fechas incorrectas, picos de GPS, movimientos incómodos de la cámara o una ruta que contiene más información personal de la prevista.

Privacidad, mapas y procesamiento local

La privacidad es una razón fundamental para utilizar un visualizador local de Google Timeline. El archivo de Timeline puede permanecer en el dispositivo mientras la aplicación analiza las coordenadas y produce el vídeo. Esto difiere de los servicios que obligan a los usuarios a subir todo su historial de desplazamientos a un servidor remoto.

El procesamiento local no significa que todas las partes del flujo de trabajo funcionen sin conexión. Los fondos de mapa normalmente requieren teselas ráster de un proveedor externo. Cada solicitud de tesela puede revelar la zona general que se está visualizando, aunque el propio JSON de Timeline nunca se suba.

ComponenteLocal o conectado a la redImpacto en la privacidad
JSON de TimelineArchivo localContiene un historial detallado de desplazamientos y debe mantenerse privado
Análisis de coordenadasProcesamiento localConvierte los registros sin acceder a la cuenta
Filtrado de rutasProcesamiento localProduce un subconjunto visual sin editar el origen
Teselas del mapa baseConectadas a la redLas solicitudes de teselas pueden revelar las regiones geográficas consultadas
MP4 finalArchivo localPuede revelar rutas, fechas y lugares al compartirlo

Antes de cargar un mapa, lee el aviso de privacidad de la aplicación y decide si el compromiso relacionado con el mapa base es aceptable. Si el proyecto ofrece una forma de cancelar antes de solicitar las teselas, utiliza ese control cuando la ruta sea demasiado sensible para un servicio de mapas externo.

Revisa también el vídeo terminado. Una animación de ruta puede revelar la ubicación de tu casa, lugares de trabajo, visitas médicas, rutinas habituales o las fechas de viajes privados. Un archivo renderizado localmente puede seguir siendo sensible una vez que se sube a una red social o se envía a otra persona.

Compartir de forma segura

Antes de compartir un MP4:

  • Elimina o acorta las secciones que revelen tu casa o tu rutina diaria.
  • Evita las publicaciones públicas que incluyan fechas exactas de viaje.
  • Comprueba los fotogramas iniciales y finales de la vista general para detectar lugares sensibles.
  • Mantén privado el JSON original, aunque el vídeo parezca inofensivo.
  • Utiliza un método de transferencia privado para los archivos familiares o personales.
Advertencia sobre la red

El archivo de Timeline puede permanecer local mientras las teselas del mapa siguen viajando por la red. Revisa la información del proveedor de teselas antes de cargar viajes sensibles.

Solución de problemas y almacenamiento a largo plazo

La mayoría de los problemas pertenecen a cuatro grupos: estructura de archivo no compatible, coordenadas con ruido, rutas dispersas o errores de gestión de la salida. Comienza con un intervalo de fechas pequeño para poder aislar el problema sin esperar a que termine una renderización grande.

Si el archivo no se carga, verifica que hayas seleccionado la exportación JSON real y no una suma de comprobación, un archivo comprimido o un archivo de Google Takeout no relacionado. Si solo aparece una parte de la ruta, comprueba si la exportación utiliza un esquema compatible con el visualizador actual. Los formatos antiguos y nuevos de Timeline pueden requerir una lógica de análisis diferente.

ProblemaCausa probableRespuesta práctica
El archivo no se cargaArchivo incorrecto o esquema no compatibleComprueba de nuevo la exportación y prueba con una copia más pequeña
La ruta salta a un lugar lejanoValor atípico de GPSActiva el filtrado conservador y vuelve a previsualizar
El vuelo dibuja una línea rectaPocos puntos de ubicaciónUtiliza la interpolación de círculo máximo si está disponible
El mapa no apareceSolicitud de teselas bloqueada o rechazadaRevisa el aviso de privacidad y el acceso a la red
El vídeo está incompletoLa renderización se canceló o se interrumpióElimina el archivo parcial y crea una renderización nueva
El vídeo está en una ubicación inesperadaComportamiento del proveedor de almacenamientoComprueba la carpeta de salida de la aplicación o el diálogo de guardado

Para conservar los datos a largo plazo, guarda tres recursos separados:

  1. La exportación original de Timeline.
  2. Una nota de procesamiento con las fechas seleccionadas y la configuración.
  3. El MP4 final o una imagen de vista general.

Un visualizador es útil para la presentación, pero no necesariamente es una base de datos espacial permanente. Los usuarios que quieran seguimiento continuo, mapas de calor de toda una vida o análisis geográficos consultables pueden preferir una plataforma de ubicación autoalojada. En esa configuración, una base de datos espacial persistente almacena el historial, mientras que el visualizador sigue siendo una herramienta de renderización especializada.

Antes de compartir un vídeo de Timeline:

  • Conserva una copia intacta del JSON original de Timeline
  • Confirma las fechas seleccionadas y los límites de la ruta
  • Revisa el filtrado de GPS y el movimiento de la cámara en la previsualización
  • Comprueba la vista general final para detectar ubicaciones de casa y trabajo
  • Guarda el MP4 separado de los datos de origen privados
Nota de archivo

Anota el intervalo de fechas, el modo de filtrado, el estilo de cámara y la versión del renderizador junto a cada MP4 terminado. Estas notas facilitan mucho las recreaciones futuras.

Preguntas frecuentes sobre Google Timeline Visualizer

Q: ¿Qué es un visualizador de Google Timeline en GitHub?

Es una utilidad de estilo código abierto que lee los datos exportados del historial de ubicaciones de Google y convierte los trayectos seleccionados en vídeos de mapas animados. El flujo de trabajo es retrospectivo y se basa en archivos, no en una conexión activa con la cuenta.

Q: ¿El visualizador sube mi JSON de Timeline?

Un flujo de trabajo local puede analizar y renderizar el JSON en tu dispositivo. Sin embargo, los fondos de mapa pueden requerir solicitudes de teselas a través de la red, por lo que debes revisar el aviso de privacidad de la aplicación antes de cargar rutas sensibles.

Q: ¿Por qué mi ruta contiene saltos imposibles?

Los registros de GPS pueden incluir valores atípicos aislados causados por señales débiles, posicionamiento en interiores o errores temporales de coordenadas. El filtrado conservador puede omitir los picos inverosímiles del vídeo renderizado y dejar el JSON original sin cambios.

Q: ¿Puede sustituir a Google Timeline para el seguimiento continuo?

No. Un visualizador crea vídeos a partir de exportaciones existentes. El seguimiento continuo, el almacenamiento persistente, los mapas de calor y los análisis a largo plazo requieren un sistema independiente de historial de ubicaciones.

Recomendación final

Utiliza el visualizador para contar historias y revisar tus trayectos, mantén privada la exportación original y elige una herramienta autoalojada persistente cuando necesites gestionar el historial de forma continua.