google timeline visualizer github repository：セットアップガイド

google timeline visualizer github repository は、Google ロケーション履歴の Timeline データをアニメーション付きの旅行動画に変換できるオープンソースの手段を提供します。クラウドダッシュボードに依存する代わりに、このツールはローカルの Timeline.json ファイルを読み込み、月単位の範囲または正確な日付を選択し、移動経路をプレビューして、視聴や共有に使える MP4 を作成します。

このプロジェクトは Android と iPhone のワークフローに対応しており、デスクトップユーザー向けには別の Python ジェネレーターも用意されています。Android アプリは Google Play ではなく GitHub リリースから配布されます。一方、iPhone ユーザーは Safari で Web アプリを開き、ホーム画面に追加できます。

動画のハイライト：

• Android または iPhone から Timeline JSON をエクスポート
• 履歴ファイルをアップロードせず、ビジュアライザーをローカルで実行
• MP4 を作成する前に経路をプレビュー
• カメラの動きと正確な日付範囲を選択
• 完成した動画をローカルライブラリに保存

ビジュアライザーには、エクスポート済みの Timeline ファイルが必要です。Android と iPhone ではエクスポートメニューが大きく異なるため、プラットフォームごとの手順を慎重に確認してください。ファイルに履歴が含まれていない場合は、まず Google Maps で Timeline を復元してから、新しいコピーを再度エクスポートします。

スマートフォンに異なるラベルが表示される場合は、リポジトリの Timeline ファイルを取得する 手順を使用してください。Android のメニュー名はメーカーによって異なる場合があり、アプリからすべてのデバイスの Timeline 設定ページへ直接アクセスできる共通リンクを提供することはできません。

このプロジェクトはローカル処理を中心に設計されています。Timeline JSON がプロジェクトのサーバーにアップロードされることはなく、エクスポートしたファイルを読み込むために Google サインインを使用する必要もありません。プロジェクトで説明されているネットワーク依存の機能は、ベースマップへのアクセスだけです。

地図タイルは CARTO にリクエストされ、OpenStreetMap のデータを使用します。これらのリクエストによって、閲覧している地図エリアがタイルプロバイダーに伝わる可能性がありますが、Timeline JSON 自体がアップロードされることはありません。特に自宅、職場、日常の移動パターンが分かる経路を扱う場合は、ファイルを読み込む前にプライバシー通知を確認してください。

アプリでは、デフォルトで Conservative GPS 外れ値フィルタリングを適用できます。この機能は、孤立した不自然な往復座標を無視しながら、元の JSON は変更しません。すべての位置情報ポイントを含める必要がある場合はフィルタリングを無効にできますが、レンダリング前に結果を慎重にプレビューしてください。

Timeline ファイルを読み込んだ後の基本的な流れは簡単です。期間を選択し、映像スタイルを設定し、経路をプレビューして、最終動画をレンダリングします。数年分の位置履歴を処理する前に、短い範囲または小さなテスト期間から始めてください。

アプリケーションは、ズームアウトして経路全体を表示する短い終了シーケンスを追加します。対応している Android バージョンでは、レンダリング中に別のアプリへ切り替えたり、画面をオフにしたりできます。Android 13 以降では、通知へのアクセスを許可すると進行状況通知を表示できます。

完成した MP4 ファイルは My videos に追加されます。各エントリーには、サムネイル、Timeline の期間、再生時間、作成日を保持できます。Add videos を使用すると、以前の MP4 ファイルを追加できます。リストから項目を削除しても、元のファイルが必ず削除されるわけではありません。一方、Delete video は別途確認が必要な操作です。

デスクトップでの自動化向けに、リポジトリには元の Python ジェネレーターも残されています。ドキュメントに記載されたセットアップでは、Python 3.9 以降、FFmpeg、requirements.txt のパッケージを使用します。

python -m pip install -r requirements.txt python visualizer.py --input Timeline.json --year 2026 --camera-movement steady

コマンドラインワークフローは、再現可能なレンダリングや一括変換を行いたい場合に便利です。入力パスはローカルに保ち、選択した年または期間を確認し、長時間のレンダリングを開始する前に FFmpeg が利用可能であることを確認してください。

このリポジトリでは、現在の直接配列形式の Timeline エクスポート、古い semanticSegments 構造、経路、アクティビティ、訪問、複数の座標形式、国際日付変更線をまたぐ経路にも対応していることが説明されています。セマンティック処理が利用できない場合は、位置情報の生データによるフォールバックで警告が表示されることがあります。

アカウントや Timeline の復元に関する詳しい手順については、Google 公式 Timeline ヘルプを参照してください。リリースファイル、プライバシーに関する説明、プラットフォーム別の手順、開発ドキュメントについては、GitHub リポジトリを利用してください。